--- title: "Update a link's credentials" method: PUT path: "/api/links/{id}/" tags: ["Links"] --- # Update a link's credentials `PUT /api/links/{id}/` Update the credentials of a specific link. If the successfully updated link is a recurrent one, we automatically trigger an update of the link. If we find fresh data, you'll receive historical update webhooks. > ๐Ÿ‘ Use our Connect Widget > > We recommend using our Connect Widget to handle updating invalid or token_required links. ## Path parameters - `id` string, uuid, required ## Request body - LinksPutRequest - `password` string, required โ€” The end-user's password used to log in to the institution. - `password2` string โ€” The end-user's second password used to log in to the institution. > ๐Ÿ“˜ Info > > This is only required by some institutions. To know which institutions require a second password, see our List institution request and check the `form_fields` array in the response. - `token` string โ€” The MFA token generated by the institution which is required to continue a session. ## Response `200` Ok - Link - `id` string, uuid โ€” Belvo's unique identifier for the current item. - `institution` string โ€” Belvo's name for the institution. - `access_mode` 'single' | 'recurrent' | 'null', nullable โ€” The link type. For more information, see our Links article. We return one of the following enum values: - `single` - `recurrent` - `null` - `last_accessed_at` string, date-time, nullable โ€” The ISO-8601 timestamp of Belvo's most recent successful access to the institution for the given link. - `created_at` string, date-time โ€” The ISO-8601 timestamp of when the data point was created in Belvo's database. - `external_id` string โ€” An additional identifier for the link, provided by you, to store in the Belvo database. **Cannot** include any Personal Identifiable Information (PII). **Must** be at least three characters long. If we identify that the identifier contains PII, we will force a `null` value. For more information, see our Link creation article. - `institution_user_id` string โ€” > ๐Ÿ“˜ Info > > Only applicable for links created **after 08-02-2022**. A unique 44-character string that can be used to identify a user at a given institution. ๐Ÿ“š Check out our Avoiding duplicated links DevPortal article for more information and tips on how to use it. - `status` 'valid' | 'invalid' | 'unconfirmed' | 'token_required' โ€” The current status of the link. For more information, see our Link article in the devportal. We return one of the following values: - `valid` - `invalid` - `unconfirmed` - `token_required` - `created_by` string, uuid โ€” The unique ID for the user that created this item. - `refresh_rate` '6h' | '12h' | '24h' | '7d' | '30d' | 'null', nullable โ€” The update refresh rate for the recurrent link. For more information, check out our recurrent link documentation in our DevPortal. We return one of the following enum values: - `6h` - `12h` - `24h` - `7d` (default) - `30d` (once a month) - `null` (for single links) - `credentials_storage` string โ€” Indicates whether or not to store credentials (and the duration for which to store the credentials). - For recurrent links, this is set to `store` by default (and cannot be changed). - For single links, this is set to `365d` by default. Can be either: - `store` to store credentials (until the link is deleted) - `nostore` to not store credentials - Any value between `1d` and `365d` to indicate the number of days you want the credentials to be stored. For more information, check out the credentials_storage section of our Data retention controls article. - `fetch_resources` string[] โ€” An array of resources that you will receive a historical update for. - `stale_in` string โ€” Indicates how long any user-derived data should be stored in Belvo's database for the link (both single and recurrent). For example, if you send through `90d`, Belvo will remove any data from its database relating to the user after 90 days. For more information, check out the stale_in section of our Data retention controls article. > ๐Ÿ“˜ Info > > Belvo will only remove data for links that have not been updated in the period you provide in `stale_in`. Belvo will only remove data for links that have not been updated in the period you provide in `stale_in`. By default Belvo stores user data for 365 days, unless the link is deleted. ## Other responses - `400` โ€” Bad request error - `401` โ€” Unauthorized - `403` โ€” Access to Belvo API denied - `404` โ€” Not Found Error - `428` โ€” MFA Token Required - `500` โ€” Unexpected Error --- [API](https://skmtc.net/belvo/apis/belvo-api-docs.md) ยท [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) ยท [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/versions/3423c786ece5/schema)