# Create or update an ES|QL data source

**PUT /_query/data_source/{name}**

Creates or replaces a named, type-specific data source configuration for ES|QL data federation.
Datasets reference data source configurations to access external data. Names must be lowercase
and follow index or alias naming rules.

## Required authorization

* Cluster privileges: `manage`


[ES|QL Data Federation](https://www.elastic.co/docs/reference/query-languages/esql/esql-data-federation)

## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters

- **name** (string)
  The data source name to create or update.


### Query parameters

- **master_timeout** (string)
  Period to wait for a connection to the master node.

- **timeout** (string)
  The time to wait for the request to be completed.


### Body: application/json (object)

- **type** (string)
  The data source type. Currently, `s3` is supported.
  The value must be lowercase and contain no whitespace.

- **description** (string)
  A free-text description of the data source.

- **settings** (object)
  Type-specific connection and authentication settings.
  For `s3`, connection settings include `region` and `endpoint`. Authentication settings
  include `auth` and the credentials required by the selected authentication method.



## Responses
### 200


#### Body: application/json (object)
- **acknowledged** (boolean)
  For a successful response, this value is always true. On failure, an exception is returned instead.



[Powered by Bump.sh](https://bump.sh)