Sign in

v1

latestOpenAPI 3.0.02026-07-26224386470.0 KB
EndUserDataSources

Update a data source

Update a data source

put/api/data_sources/{heron_id}

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-06-11T19:53:47.134564",
  "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_Voz4MiFfCsdRcFRGdeeEQr",
  "is_enabled": true,
  "last_updated": "2026-07-23T19:53:47.134594",
  "metadata": {
    "currency": "USD",
    "filename": "202348_JAN_2022.pdf",
    "integration_heron_id": "itg_Qz4JR9HpTCveV9DT7BvXnp",
    "integration_item_id": "Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr",
    "last_successful_sync": "2026-07-23T19:53:47.133729",
    "notes": "error with processing, 52 invalid transaction(s) extracted from statement",
    "parsing_version": "1.0.0",
    "sub_type": "transaction"
  },
  "reference_id": "pdf_Tnx6TaGVo4MykKizfYwoLh",
  "status": "new",
  "type": "pdf"
}