---
title: "Modify credentials"
method: PUT
path: "/api/v1/credentials/{id}"
tags: ["Connectivity v1.Credentials"]
---

# Modify credentials

`PUT /api/v1/credentials/{id}`

Modify the specified credentials. The request will trigger a refresh towards the provider.

## Path parameters

- `id` string, required

## Request body

- UpdateCredentialsRequest — The new credentials object.
  - `appUri` string — The end user will be redirected to this URI after the authorization code has been delivered. This field is used for flows where we have third party redirects to financial institutions. There is a default value which is tink://open. It can be any type of URI (mobile deeplink, http address etc.)
  - `callbackUri` string — This URI will be used by the ASPSP to pass the authorization code. It corresponds to the redirect/callback URI in OAuth2/OpenId. This parameter is only applicable if you are a TPP.
  - `fields` object — This is a key-value map of `Field` name and value found on the `Provider` to which the credentials belongs to.
  - `originatingUserIp` string — The originating user's remote IP address of the corresponding HTTP request.
  - `providerName` string — The provider (financial institution) that the credentials is connected to.
  - `selectedAuthenticationOptions` SelectedAuthenticationOption[] — [BETA] Specifies the selected authentication options for each available group when a provider has more than one authentication option available in any of the available groups.
    - `authenticationOptionDefinition` string — Specifies the selected authentication option. This is only required if selectedAuthenticationOptions is used.
    - `authenticationOptionsGroup` string — Specifies the authentication option group for which we have selected an authentication option. This is only required if selectedAuthenticationOptions is used.
    - `fields` object — Specifies the values for the fields that are required to be sent when this authentication option is selected, if any.
  - `triggerRefresh` boolean — Defines if the Credentials update should cause the Credentials refresh. Defaults to `true`

## Response `200`

The credentials was successfully modified.

- Connectivity20v1Credentials — unresolved $ref

## Other responses

- `400` — The payload does not pass validation.
- `404` — The credentials could not be found.
- `409` — Another ongoing request is in progress.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)