HEherondata
Integrations

Update an Integration Link

Allows refreshing the access_token of an existing Integration Link

put/api/integration_links/{item_id}

Request

  • Base URL
    https://app.herondata.io
  • URL
    https://app.herondata.io/api/integration_links/{item_id}
  • Auth
    API key in header x-api-key

Path parameters

item_idstring required

Request body

Example request

{
  "end_user": {
    "access_token": "access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6"
  }
}

Response

OK

Example response

{
  "integration_link": {
    "access_token": "access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6",
    "created": "2020-01-01T00:00:00Z",
    "end_user_id": "feb06237-cb82-482a-8a6e-dd5198127668",
    "end_user_name": "Acme Corp",
    "item_id": "M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op",
    "last_successful_sync": "2020-01-01T00:00:00Z",
    "last_updated": "2020-01-01T00:00:00Z",
    "status": "active",
    "status_message": "[ITEM_LOGIN_REQUIRED] the login details of this item have changed (credentials, MFA, or required user action) and a user login is required to update this information. use Link's update mode to restore the item to a good state",
    "type": "plaid_assets_report"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.