---
title: "Update an Integration Link"
method: PUT
path: "/api/integration_links/{item_id}"
tags: ["Integrations"]
---

# Update an Integration Link

`PUT /api/integration_links/{item_id}`

Allows refreshing the access_token of an existing Integration Link

## Path parameters

- `item_id` string, required

## Request body

- object
  - `end_user` IntegrationLinkUpdateSchema
    - `access_token` string, required — The generated token that grants access to the bank (this is encrypted in transit and at-rest with a custom key)

## Response `200`

OK

- object
  - `integration_link` IntegrationLinkSchema
    - `access_token` string, required — The generated token that grants access to the bank (this is encrypted in transit and at-rest with a custom key)
    - `asset_report_token` string, nullable — Optional. If you already have a Plaid asset report, pass the token to skip creating a new one.
    - `created` string, date-time — When the integration link was created in Heron system
    - `end_user_id` string, required — A unique identifier for your end user (customer) generated by you
    - `end_user_name` string — An human readable name for this end user, like the company legal name
    - `item_id` string, required — Unique identifier for each bank connection made by your end users. In Plaid this is the 'item_id'.
    - `last_successful_sync` string, date-time — When the integration link was last successfully synced
    - `last_updated` string, date-time — When the integration link was last updated in Heron system
    - `status` 'pending' | 'active' | 'syncing' | 'erroring' | 'sync_disabled' | 'deleted_in_plaid' — The integration link status
    - `status_message` string — A message describing the 'erroring' status of the integration link
    - `type` string — The integration link type, inherited from the integration: plaid_assets_report or plaid_integration

---

[API](https://skmtc.net/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.net/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/herondata/heron-data-api/versions/f2e441edece2/schema)