HEherondata
EndUserDataSources

Update a data source

Changed on

Update a data source

put/api/data_sources/{heron_id}

Request

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

Path parameters

heron_idstring required

Request body

is_enabledboolean

Whether or not the data source is enabled. If disabled, hides related transactions from analytics

Example request

{
  "is_enabled": true
}

Response

Ok

createdstring date-time required

When the data source was created in Heron system

heron_idstring required

Unique ID for data source generated by Heron

is_enabledboolean

Whether or not the data source is enabled. If disabled, hides related transactions from analytics

last_updatedstring date-time required

When the data source was last updated in Heron system

reference_idstring 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

Example response

{
  "created": "2026-09-21T23:44:30.564561",
  "data_source_accounts": [
    {
      "account_id": "202348",
      "anomaly_reasons": [
        "Statement metadata changed",
        "Manual review flagged suspicious edits"
      ],
      "anomaly_score": 200,
      "enabled": true,
      "max_date": "2022-01-31",
      "min_date": "2022-01-01",
      "num_transactions": 120,
      "transactions_match_balances": true
    }
  ],
  "heron_id": "dso_iGs8kuDF7KbcfvJMiAQt5v",
  "is_enabled": true,
  "last_updated": "2026-11-02T23:44:30.564590",
  "metadata": {
    "currency": "USD",
    "filename": "202348_JAN_2022.pdf",
    "integration_heron_id": "itg_57Wme8xodc7wMcJv2FuupA",
    "integration_item_id": "Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr",
    "last_successful_sync": "2026-11-02T23:44:30.563937",
    "notes": "Statement processed successfully. All balances verified.",
    "parsing_version": "1.0.0",
    "sub_type": "transaction"
  },
  "reference_id": "pdf_F9VTGQPbDaBD2Ay5Dky8fX",
  "status": "new",
  "type": "pdf"
}

Changes

  • bd8008e49534Revision changes
    • breaking

      the response property // became nullable for the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status