v1

latestOpenAPI 3.0.02026-07-26224386470.0 KB

Integrations

Refresh an IntegrationLink

Trigger a refresh operation for an IntegrationLink

post/api/integrations/{heron_id}/links/{link_item_id}/refresh

Path parameters

heron_idstring required

The Integration's heron_id

link_item_idstring required

The IntegrationLink's item_id

Response

Example response

{
  "link": {
    "access_token": "access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6",
    "created": "2020-01-01T00:00:00Z",
    "end_user_id": "7de477c5-2c5f-4de4-8bc6-edb935176f9a",
    "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"
  }
}