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

# Update an authentication configuration

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

Modifies an existing authentication configuration with new credentials or other settings. Only specified fields will be updated.

## Path parameters

- `nanoid` string, authConfigId, required — The unique identifier of the authentication configuration to update

## Request body

- union
  - object
    - `type` 'custom', required
    - `name` string — The display name of the authentication configuration
    - `credentials` object
      - `scopes` union — OAuth scopes requested for the auth config.
        - string
        - string[]
      - `user_scopes` union — OAuth user-token scopes requested for the auth config. This is primarily used by Slack OAuth v2.
        - string
        - string[]
    - `proxy_config` object, nullable
      - `proxy_url` string, uri, required — The url of the auth proxy
      - `proxy_auth_key` string — The auth key for the auth proxy
    - `restrict_to_following_tools` string[] — Use tool_access_config instead. This field will be deprecated in the future.
    - `tool_access_config` object
      - `tools_for_connected_account_creation` string[] — Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes.
      - `tools_available_for_execution` string[] — The actions that the user can perform on the auth config. If passed, this will update the actions that the user can perform on the auth config.
    - `shared_credentials` object — Shared credentials inherited by all connected accounts using this auth config. Secret values are redacted in responses, so provide the real values when updating; omit this field to leave them unchanged.
    - `is_enabled_for_tool_router` boolean — Whether this auth config is enabled for tool router
  - object
    - `type` 'default', required
    - `name` string — The display name of the authentication configuration
    - `scopes` union — OAuth scopes requested for the auth config.
      - string
      - string[]
    - `user_scopes` union — OAuth user-token scopes requested for the auth config. This is primarily used by Slack OAuth v2.
      - string
      - string[]
    - `restrict_to_following_tools` string[] — Use tool_access_config instead. This field will be deprecated in the future.
    - `tool_access_config` object
      - `tools_for_connected_account_creation` string[] — Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes.
      - `tools_available_for_execution` string[] — The actions that the user can perform on the auth config. If passed, this will update the actions that the user can perform on the auth config.
    - `shared_credentials` object — Shared credentials inherited by all connected accounts using this auth config. Secret values are redacted in responses, so provide the real values when updating; omit this field to leave them unchanged.
    - `is_enabled_for_tool_router` boolean — Whether this auth config is enabled for tool router

## Response `200`

Successfully updated auth config

- object

## Other responses

- `400` — Bad request - Invalid input or credentials format
- `401` — Unauthorized - Authentication required
- `404` — Not found - Auth configuration does not exist
- `500` — Internal server error - Something went wrong on the server

---

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