---
title: "Update an Application Provider Link"
method: PATCH
path: "/v1/applications/{id}/providers/{providerId}"
tags: ["Application Providers API"]
---

# Update an Application Provider Link

`PATCH /v1/applications/{id}/providers/{providerId}`

Use this endpoint to update the permissions and settings of a provider linked to an application.

## Path parameters

- `id` string, required
- `providerId` string, required

## Request body

- ProviderItemUpdateInput — Information used to update a provider link on an application. All fields are optional.
  - `canSignIn` boolean — Whether users can sign in using this provider.
  - `canSignUp` boolean — Whether new users can sign up using this provider.
  - `canUnlink` boolean — Whether users can unlink this provider from their account.
  - `prompted` boolean — Whether users are prompted to link this provider on login.
  - `alertType` string — Alert type configuration for this provider link.
  - `rule` string — Custom rule applied to this provider link.

## Response `200`

Indicates that the provider link was successfully updated.

- ProviderItemResponse — Information about a provider linked to an application.
  - `providerId` string — Unique identifier of the linked provider.
  - `category` 'Email' | 'SMS' — Provider category.
  - `type` 'SendGrid' | 'Twilio' — Provider implementation type.
  - `canSignIn` boolean — Whether users can sign in using this provider.
  - `canSignUp` boolean — Whether new users can sign up using this provider.
  - `canUnlink` boolean — Whether users can unlink this provider from their account.
  - `prompted` boolean — Whether users are prompted to link this provider on login.
  - `alertType` string — Alert type configuration for this provider link.
  - `rule` string — Custom rule applied to this provider link.

## Other responses

- `400`
- `404`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)