Skip to main content
PUT
/
api
/
data_sources
/
{heron_id}
Update a data source
curl --request PUT \
  --url https://app.herondata.io/api/data_sources/{heron_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "is_enabled": true
}
'
{
  "created": "2026-04-01T22:20:33.326239",
  "data_source_accounts": [
    {
      "account_id": "202348",
      "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_YVsaFngTsUo2NghwQDcHaP",
  "last_updated": "2026-05-13T22:20:33.326262",
  "reference_id": "pdf_M7MTUWHLaf8ehGrtHs8QzW",
  "type": "pdf",
  "is_enabled": true,
  "metadata": {
    "filename": "202348_JAN_2022.pdf",
    "status": "processed"
  },
  "status": "new"
}

Documentation Index

Fetch the complete documentation index at: https://docs.herondata.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
heron_id
string
required

Body

application/json
​
is_enabled
boolean
default:true

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

Example:

true

Response

200 - application/json

Ok

​
created
string<date-time>
required

When the data source was created in Heron system

Example:

"2026-04-01T22:20:33.326239"

​
data_source_accounts
object[]
required

List of data source accounts associated with the data source

Example:
[
  {
    "account_id": "202348",
    "anomaly_score": 200,
    "enabled": true,
    "max_date": "2022-01-31",
    "min_date": "2022-01-01",
    "num_transactions": 120,
    "transactions_match_balances": true
  }
]
​
heron_id
string
required
read-only

Unique ID for data source generated by Heron

Example:

"dso_YVsaFngTsUo2NghwQDcHaP"

​
last_updated
string<date-time>
required

When the data source was last updated in Heron system

Example:

"2026-05-13T22:20:33.326262"

​
reference_id
string
required

Unique ID to identify the data source

Example:

"pdf_M7MTUWHLaf8ehGrtHs8QzW"

​
type
enum<string>
required

Data source type

Available options:
api,
csv,
pdf,
integration_link,
legacy,
legacy_pdf,
legacy_integration_link
Example:

"pdf"

​
is_enabled
boolean
default:true

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

Example:

true

​
metadata
object

Metadata associated with the data source

Example:
{
  "filename": "202348_JAN_2022.pdf",
  "status": "processed"
}
​
status
enum<string>

Status of the data source entity, where applicable (e.g. pdfs, integration links)

Available options:
new,
parsing,
parsed,
processed,
human_reviewing,
approved,
rejected,
failed,
transactions_loaded,
transactions_unloaded,
pending,
active,
syncing,
erroring,
sync_disabled,
deleted_in_plaid,
unknown
Example:

"new"