---
title: "Get data source configuration"
method: GET
path: "/datasources/{datasourceId}"
tags: ["🧩 Data sources"]
---

# Get data source configuration

`GET /datasources/{datasourceId}`

Get the configuration of a data source

## Path parameters

- `datasourceId` string, required

## Response `200`

Data source information

- object
  - `result` 'success' | 'error', required — Result of the request
  - `action` 'getDataSource', required — The id of the action
  - `data` object, required
    - `datasources` Datasource[], required
      - `id` string — Unique identifier of the data source to create.
      - `name` string — The human readable name of the data source to create.
      - `description` string — Description of the goal of the data source to create.
      - `enabled` boolean — Enable or disable data source.
      - `updateTimeout` integer — Duration in seconds before aborting data source update. The main goal is to prevent never ending requests. If a periodicity if configured, you should set that timeout at a lower value.
      - `runParameters` object — Parameters to configure when the data source is fetched to update node properties.
        - `onGeneration` boolean — Trigger a fetch at the beginning of a policy generation
        - `onNewNode` boolean — Trigger a fetch when a new node is accepted, for that node
        - `schedule` object — Configure if data source should be fetch periodically
          - `type` 'scheduled' | 'notscheduled' — `scheduled` enables periodic update, `notscheduled` disables them
      - `type` object — Define and configure data source type.
        - `name` 'HTTP' — Data source type name
        - `parameters` object — You can use Rudder variable expansion (`${rudder.node`, `${node.properties...}`)
          - `url` string — URL to contact. Rudder expansion available.
          - `requestMethod` 'GET' | 'POST' — HTTP method to use to contact the URL.
          - `headers` object[] — Represent HTTP headers for the query. Rudder expansion available.
            - `name` string — Name of the header
            - `value` string — Value of the header
          - `path` string — JSON path (as defined in [the specification](https://github.com/jayway/JsonPath/), without the leading `$.`) to find the interesting sub-json or string/number/boolean value in the answer. Let empty to use the whole answer as value.
          - `checkSsl` boolean — Check SSL certificate validity for https. Must be set to false for self-signed certificate
          - `requestTimeout` integer — Timeout in seconds for each HTTP request
          - `requestMode` object — Configure the strategy used to query the HTTP data source.
            - `name` 'byNode' — Node by node strategy

---

[API](https://skmtc.net/rudder/apis/rudder-api.md) · [All operations](https://skmtc.net/rudder/apis/rudder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rudder/rudder-api/versions/eab988254fba/schema)