---
title: "PATCH /api/dashboard/data-sources/{data_source_id}/"
method: PATCH
path: "/api/dashboard/data-sources/{data_source_id}/"
tags: ["Dashboard data sources"]
---

# PATCH /api/dashboard/data-sources/{data_source_id}/

`PATCH /api/dashboard/data-sources/{data_source_id}/`

Updates an existing dashboard data source.

## Path parameters

- `data_source_id` integer, required

## Headers

- `ClientSessionId` string, uuid
- `ClientUndoRedoActionGroupId` string, uuid

## Request body

- union
  - LocalBaserowGetRowUpdateDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `search_query` object — Any search queries to apply to the service when it is dispatched.
    - `row_id` object — A formula for defining the intended row.
  - LocalBaserowListRowsUpdateDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `search_query` object — Any search queries to apply to the service when it is dispatched.
    - `default_result_count` integer — The default record count returned with each page.
  - LocalBaserowAggregateRowsUpdateDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `search_query` object — Any search queries to apply to the service when it is dispatched.
    - `field_id` integer, nullable — The id of the Baserow field we want to aggregate on.
    - `aggregation_type` string — The field aggregation type.
  - LocalBaserowUpsertRowUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `field_mappings` LocalBaserowTableServiceFieldMapping[] — The field mapping associated with this service.
      - `field_id` integer, required — The primary key of the associated database table field.
      - `enabled` boolean, required — Indicates whether the field mapping is enabled or not.
      - `value` object
    - `row_id` object — A formula for defining the intended row.
  - LocalBaserowCreateRowsUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `rows` object — The rows to create.
  - LocalBaserowUpdateRowsUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `rows` object — The rows to update. Each row must contain an `id` property.
  - LocalBaserowDeleteRowUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `row_id` object — A formula for defining the intended row.
  - LocalBaserowRowsCreatedUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
  - LocalBaserowRowsUpdatedUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
  - LocalBaserowRowsDeletedUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
  - LocalBaserowFieldsUpdatedUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `field_ids` integer[] — The ids of the fields whose change triggers the workflow.
  - SlackWriteMessageServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the Slack bot integration.
    - `name` string
    - `channel` string — The Slack channel ID where the message will be sent.
    - `text` object — The text content of the Slack message.
  - CoreHTTPRequestServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `http_method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' — * `GET` - GET * `POST` - POST * `PUT` - PUT * `DELETE` - DELETE * `PATCH` - PATCH * `HEAD` - HEAD * `OPTIONS` - OPTIONS
    - `url` object — The URL to which the HTTP request will be sent.
    - `headers` HTTPHeader[] — The headers for the request.
      - `id` integer, required
      - `key` string, required
      - `value` object
    - `query_params` HTTPQueryParam[] — The query params for the request.
      - `id` integer, required
      - `key` string, required
      - `value` object
    - `form_data` HTTPFormData[] — The form data for the request.
      - `id` integer, required
      - `key` string, required
      - `value` object
    - `body_type` 'json' | 'form' | 'raw' | 'none' — * `json` - JSON * `form` - Form Data * `raw` - Raw * `none` - None
    - `body_content` object — The content of the body of the HTTP request.
    - `timeout` integer — The timeout for the HTTP request in seconds.
    - `sample_data` unknown, required
  - CoreSMTPEmailServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The id of the SMTP integration.
    - `name` string
    - `use_instance_smtp_settings` boolean — Whether to use the instance-level Django SMTP configuration.
    - `instance_smtp_settings_enabled` boolean, required — Whether the instance SMTP configuration can be used and should be the default option in the UI.
    - `from_email` object — The sender's email address.
    - `from_name` object — The sender's name.
    - `to_emails` object — Comma-separated list of recipient email addresses.
    - `cc_emails` object — Comma-separated list of CC email addresses.
    - `bcc_emails` object — Comma-separated list of BCC email addresses.
    - `subject` object — The email subject.
    - `body_type` 'plain' | 'html' — * `plain` - Plain Text * `html` - HTML
    - `body` object — The email body content.
  - CoreRouterServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `default_edge_label` string — The label to apply next to router edge.
    - `edges` CoreRouterServiceEdge[] — The edges associated with this service.
      - `uid` string, uuid
      - `label` string — The label to apply next to router edge.
      - `order` string, decimal, required — Lowest first.
      - `condition` object
  - CoreGotoServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `condition` object — The formula that must evaluate to true for the jump to the destination service to be followed.
    - `destination_service_id` integer, nullable — The service to jump to when the condition evaluates to true.
  - CoreHTTPTriggerServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `uid` string, uuid — The service identifier for the webhook.
    - `exclude_get` boolean — Whether the service should exclude GET requests for added security. By default all HTTP methods listed in the API endpoint are supported.
    - `is_public` boolean — Defines whether the service is published or not.
  - CoreManualTriggerServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
  - CoreIteratorServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `source` object — The path of the array.
  - CorePeriodicServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `interval` 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH', required — * `MINUTE` - MINUTE * `HOUR` - HOUR * `DAY` - DAY * `WEEK` - WEEK * `MONTH` - MONTH
    - `minute` integer, nullable — The minute of the hour when to run (0-59). Required for hourly, daily, weekly, monthly intervals.
    - `hour` integer, nullable — The hour of the day when to run (0-23). Required for daily, weekly, monthly intervals.
    - `day_of_week` integer, nullable — The day of the week when to run (0=Monday, 6=Sunday). Required for weekly intervals.
    - `day_of_month` integer, nullable — The day of the month when to run (1-31). Required for monthly intervals.
    - `next_run_at` string, date-time, nullable — The next scheduled time for this service to run. Automatically calculated based on the interval and schedule fields.
  - CoreCSVFileReaderServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `file` object — The CSV file to read.
    - `csv` object — The raw CSV data to read.
    - `input_type` 'file' | 'content' — * `file` - File * `content` - Content
    - `separator` ',' | ';' | '	' | '|' — * `,` - Comma * `;` - Semicolon * ` ` - Tab * `|` - Pipe
    - `encoding` 'utf-8' | 'utf-8-sig' | 'latin-1' — * `utf-8` - UTF-8 * `utf-8-sig` - UTF-8 with BOM * `latin-1` - Latin-1
    - `first_line_is_header` boolean — Whether the first line of the CSV file contains column names.
  - CoreStartWorkflowServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `workflow_id` integer, nullable — The automation workflow to start.
  - AIAgentServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The ID of the AI integration to use for this service.
    - `name` string
    - `ai_generative_ai_type` string, nullable — The generative AI provider type (e.g., 'openai', 'anthropic').
    - `ai_generative_ai_model` string, nullable — The specific AI model to use (e.g., 'gpt-4', 'claude-3-opus').
    - `ai_output_type` 'text' | 'choice' — * `text` - Text * `choice` - Choice
    - `ai_temperature` number, double, nullable — Temperature for response randomness (0-2). Lower is more focused.
    - `ai_prompt` object — The prompt to send to the AI model. Can be a formula.
    - `ai_choices` string[] — List of choice options for 'choice' output type.
  - LocalBaserowGroupedAggregateRowsUpdateDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `name` string
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `aggregation_series` LocalBaserowTableServiceAggregationSeries[]
      - `id` integer
      - `aggregation_type` string — The field aggregation type.
      - `field_id` integer, nullable, required
    - `aggregation_group_bys` LocalBaserowTableServiceAggregationGroupBy[]
      - `order` integer, required
      - `field_id` integer, nullable, required
    - `aggregation_sorts` LocalBaserowTableServiceAggregationSortBy[]
      - `order` integer, required
      - `sort_on` 'SERIES' | 'GROUP_BY' | 'PRIMARY', required — * `SERIES` - Series * `GROUP_BY` - Group by * `PRIMARY` - Primary
      - `reference` string, required
      - `direction` 'ASC' | 'DESC', required — * `ASC` - Ascending * `DESC` - Descending
  - CoreCodeServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `code` string — The code to execute.
    - `injections` CoreCodeServiceInjection[] — The values to inject into the code executor context.
      - `id` integer, required
      - `name` string, required
      - `formula` object
  - CoreXLSFileReaderServiceUpdateDashboardDataSource
    - `integration_id` integer, nullable — The related integration id.
    - `name` string
    - `file` object — The XLS or XLSX file to read.
    - `sheet_name` object — The sheet to read. The first sheet is used when empty.
    - `first_line_is_header` boolean — Whether the first line of the spreadsheet contains column names.

## Response `200`

- union
  - LocalBaserowGetRowDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `search_query` object — Any search queries to apply to the service when it is dispatched.
    - `row_id` object — A formula for defining the intended row.
  - LocalBaserowListRowsDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `search_query` object — Any search queries to apply to the service when it is dispatched.
    - `default_result_count` integer — The default record count returned with each page.
  - LocalBaserowAggregateRowsDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `search_query` object — Any search queries to apply to the service when it is dispatched.
    - `field_id` integer, nullable — The id of the Baserow field we want to aggregate on.
    - `aggregation_type` string — The field aggregation type.
  - LocalBaserowUpsertRowDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `field_mappings` LocalBaserowTableServiceFieldMapping[] — The field mapping associated with this service.
      - `field_id` integer, required — The primary key of the associated database table field.
      - `enabled` boolean, required — Indicates whether the field mapping is enabled or not.
      - `value` object
    - `row_id` object — A formula for defining the intended row.
  - LocalBaserowCreateRowsDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `rows` object — The rows to create.
  - LocalBaserowUpdateRowsDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `rows` object — The rows to update. Each row must contain an `id` property.
  - LocalBaserowDeleteRowDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `row_id` object — A formula for defining the intended row.
  - LocalBaserowRowsCreatedDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
  - LocalBaserowRowsUpdatedDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
  - LocalBaserowRowsDeletedDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
  - LocalBaserowFieldsUpdatedDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `field_ids` integer[] — The ids of the fields whose change triggers the workflow.
  - SlackWriteMessageServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Slack bot integration.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `channel` string — The Slack channel ID where the message will be sent.
    - `text` object — The text content of the Slack message.
  - CoreHTTPRequestServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `http_method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' — * `GET` - GET * `POST` - POST * `PUT` - PUT * `DELETE` - DELETE * `PATCH` - PATCH * `HEAD` - HEAD * `OPTIONS` - OPTIONS
    - `url` object — The URL to which the HTTP request will be sent.
    - `headers` HTTPHeader[] — The headers for the request.
      - `id` integer, required
      - `key` string, required
      - `value` object
    - `query_params` HTTPQueryParam[] — The query params for the request.
      - `id` integer, required
      - `key` string, required
      - `value` object
    - `form_data` HTTPFormData[] — The form data for the request.
      - `id` integer, required
      - `key` string, required
      - `value` object
    - `body_type` 'json' | 'form' | 'raw' | 'none' — * `json` - JSON * `form` - Form Data * `raw` - Raw * `none` - None
    - `body_content` object — The content of the body of the HTTP request.
    - `timeout` integer — The timeout for the HTTP request in seconds.
  - CoreSMTPEmailServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the SMTP integration.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `use_instance_smtp_settings` boolean — Whether to use the instance-level Django SMTP configuration.
    - `instance_smtp_settings_enabled` boolean, required — Whether the instance SMTP configuration can be used and should be the default option in the UI.
    - `from_email` object — The sender's email address.
    - `from_name` object — The sender's name.
    - `to_emails` object — Comma-separated list of recipient email addresses.
    - `cc_emails` object — Comma-separated list of CC email addresses.
    - `bcc_emails` object — Comma-separated list of BCC email addresses.
    - `subject` object — The email subject.
    - `body_type` 'plain' | 'html' — * `plain` - Plain Text * `html` - HTML
    - `body` object — The email body content.
  - CoreRouterServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `default_edge_label` string — The label to apply next to router edge.
    - `edges` CoreRouterServiceEdge[] — The edges associated with this service.
      - `uid` string, uuid
      - `label` string — The label to apply next to router edge.
      - `order` string, decimal, required — Lowest first.
      - `condition` object
  - CoreGotoServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `condition` object — The formula that must evaluate to true for the jump to the destination service to be followed.
    - `destination_service_id` integer, nullable — The service to jump to when the condition evaluates to true.
  - CoreHTTPTriggerServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `uid` string, uuid — The service identifier for the webhook.
    - `exclude_get` boolean — Whether the service should exclude GET requests for added security. By default all HTTP methods listed in the API endpoint are supported.
    - `is_public` boolean — Defines whether the service is published or not.
  - CoreManualTriggerServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
  - CoreIteratorServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `source` object — The path of the array.
  - CorePeriodicServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `interval` 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH', required — * `MINUTE` - MINUTE * `HOUR` - HOUR * `DAY` - DAY * `WEEK` - WEEK * `MONTH` - MONTH
    - `minute` integer, nullable — The minute of the hour when to run (0-59). Required for hourly, daily, weekly, monthly intervals.
    - `hour` integer, nullable — The hour of the day when to run (0-23). Required for daily, weekly, monthly intervals.
    - `day_of_week` integer, nullable — The day of the week when to run (0=Monday, 6=Sunday). Required for weekly intervals.
    - `day_of_month` integer, nullable — The day of the month when to run (1-31). Required for monthly intervals.
    - `next_run_at` string, date-time, nullable — The next scheduled time for this service to run. Automatically calculated based on the interval and schedule fields.
  - CoreCSVFileReaderServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `file` object — The CSV file to read.
    - `csv` object — The raw CSV data to read.
    - `input_type` 'file' | 'content' — * `file` - File * `content` - Content
    - `separator` ',' | ';' | '	' | '|' — * `,` - Comma * `;` - Semicolon * ` ` - Tab * `|` - Pipe
    - `encoding` 'utf-8' | 'utf-8-sig' | 'latin-1' — * `utf-8` - UTF-8 * `utf-8-sig` - UTF-8 with BOM * `latin-1` - Latin-1
    - `first_line_is_header` boolean — Whether the first line of the CSV file contains column names.
  - CoreStartWorkflowServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `workflow_id` integer, nullable — The automation workflow to start.
  - AIAgentServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The ID of the AI integration to use for this service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `ai_generative_ai_type` string, nullable — The generative AI provider type (e.g., 'openai', 'anthropic').
    - `ai_generative_ai_model` string, nullable — The specific AI model to use (e.g., 'gpt-4', 'claude-3-opus').
    - `ai_output_type` 'text' | 'choice' — * `text` - Text * `choice` - Choice
    - `ai_temperature` number, double, nullable — Temperature for response randomness (0-2). Lower is more focused.
    - `ai_prompt` object — The prompt to send to the AI model. Can be a formula.
    - `ai_choices` string[] — List of choice options for 'choice' output type.
  - LocalBaserowGroupedAggregateRowsDashboardDataSource — A serializer mixin for services which implement the local Baserow filterable mixin. It ensures that when serialize the service, *all* filters (including those pointing to trashed fields) are serialized.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable — The id of the Baserow integration we want the data for.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `table_id` integer, nullable — The id of the Baserow table we want the data for.
    - `view_id` integer, nullable — The id of the Baserow view we want the data for.
    - `filter_type` 'AND' | 'OR' — * `AND` - And * `OR` - Or
    - `aggregation_series` LocalBaserowTableServiceAggregationSeries[]
      - `id` integer
      - `aggregation_type` string — The field aggregation type.
      - `field_id` integer, nullable, required
    - `aggregation_group_bys` LocalBaserowTableServiceAggregationGroupBy[]
      - `order` integer, required
      - `field_id` integer, nullable, required
    - `aggregation_sorts` LocalBaserowTableServiceAggregationSortBy[]
      - `order` integer, required
      - `sort_on` 'SERIES' | 'GROUP_BY' | 'PRIMARY', required — * `SERIES` - Series * `GROUP_BY` - Group by * `PRIMARY` - Primary
      - `reference` string, required
      - `direction` 'ASC' | 'DESC', required — * `ASC` - Ascending * `DESC` - Descending
  - CoreCodeServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `code` string — The code to execute.
    - `injections` CoreCodeServiceInjection[] — The values to inject into the code executor context.
      - `id` integer, required
      - `name` string, required
      - `formula` object
  - CoreXLSFileReaderServiceDashboardDataSource — Basic data source serializer mostly for returned values. This serializer flatten the service properties so that from an API POV only the data source object exists.
    - `id` integer, required — Data source id.
    - `integration_id` integer, nullable, required — The integration used to establish the connection with the service.
    - `type` string, required — The type of the data source.
    - `schema` object, required — The schema of the service.
    - `context_data` object, required — The context data of the service.
    - `context_data_schema` object, required — The schema context data of the service.
    - `sample_data` unknown, required
    - `name` string, required — Human name for this data source.
    - `dashboard_id` integer, required — Dashboard this data source is linked to.
    - `order` string, required — Lowest first.
    - `file` object — The XLS or XLSX file to read.
    - `sheet_name` object — The sheet to read. The first sheet is used when empty.
    - `first_line_is_header` boolean — Whether the first line of the spreadsheet contains column names.

## Other responses

- `400`
- `401`
- `404`

---

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