---
title: "Update a data source"
method: PUT
path: "/api/data_sources/{heron_id}"
tags: ["EndUserDataSources"]
---

# Update a data source

`PUT /api/data_sources/{heron_id}`

Update a data source

## Path parameters

- `heron_id` string, required

## Request body

- EndUserDataSourceUpdateSchema
  - `is_enabled` boolean — Whether or not the data source is enabled. If disabled, hides related transactions from analytics

## Response `200`

Ok

- EndUserDataSource
  - `created` string, date-time, required — When the data source was created in Heron system
  - `data_source_accounts` DataSourceAccount[], required — List of data source accounts associated with the data source
    - `account_id` string — Unique account id associated with the data source account
    - `anomaly_reasons` string[], nullable — Reasons associated with anomaly_score for pdf bank statement account sources
    - `anomaly_score` integer — For pdf bank statement account sources, where the value is between 0 and 1000, with 1000 being the most anomalous
    - `balances` AccountBalance[] — List of balances associated with the account
      - `closing_amount` Money, required
        - `amount` number — The amount of money
        - `currency` string — The currency of the money
      - `currency` string — Currency of the balance
      - `date` string, date — Date of the balance
    - `currency` string — Currency of the account
    - `display_account_id` string, nullable — Human-readable account label for display: the last four digits of the account number (falling back to the account title). Not unique and not a key; use account_id to join.
    - `end_date` string, date — End date of the account
    - `heron_id` string — Unique ID for data source generated by Heron
    - `institution_name` string — Name of the institution
    - `is_enabled` boolean, required — Whether or not the account is enabled. If disabled, hides related transactions from analytics
    - `max_date` string, date — Latest date of transactions associated with the data source account
    - `min_date` string, date — Earliest date of transactions associated with the data source account
    - `name` string — Name of the account
    - `num_transactions` integer — Number of transactions associated with the data source account
    - `number` string — Number of the account
    - `owner_name` string — Name of the account owner
    - `reference_id` string — This is the account ID provided as part of the transaction
    - `start_date` string, date — Start date of the account
    - `transactions_match_balances` boolean — For pdf bank statements, represents whether all transactions extracted match the balances extracted
    - `type` string — Type of the account
  - `heron_id` string, required — Unique ID for data source generated by Heron
  - `is_enabled` boolean — Whether or not the data source is enabled. If disabled, hides related transactions from analytics
  - `last_updated` string, date-time, required — When the data source was last updated in Heron system
  - `metadata` DataSourceMetadata
    - `currency` string — Currency associated with the data source entity, where applicable (e.g. pdfs)
    - `filename` string — Name of the file uploaded, where applicable (e.g. pdfs)
    - `integration_heron_id` string — Unique Heron ID associated with an integration
    - `integration_item_id` string — Unique item id associated with integration link data sources
    - `last_successful_sync` string, date-time — Last successful sync date associated with integration link data sources
    - `notes` string — Notes associated with the data source entity, where applicable (e.g. pdfs)
    - `parsing_version` string — Parsing version associated with the data source entity, where applicable (e.g. pdfs)
    - `sub_type` string — Sub type of the data source entity, where applicable (e.g. integration links)
  - `reference_id` string, required — Unique ID to identify the data source
  - `status` 'new' | 'parsing' | 'parsed' | 'processed' | 'human_reviewing' | 'approved' | 'rejected' | 'failed' | 'transactions_loaded' | 'transactions_unloaded' | 'pending' | 'active' | 'syncing' | 'erroring' | 'sync_disabled' | 'deleted_in_plaid' | 'unknown' — Status of the data source entity, where applicable (e.g. pdfs, integration links)
  - `type` 'api' | 'csv' | 'pdf' | 'integration_link' | 'legacy' | 'legacy_pdf' | 'legacy_integration_link', required — Data source type

---

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