---
title: "PATCH /api/integration/{integration_id}/"
method: PATCH
path: "/api/integration/{integration_id}/"
tags: ["Integrations"]
---

# PATCH /api/integration/{integration_id}/

`PATCH /api/integration/{integration_id}/`

Updates an existing integration.

## Path parameters

- `integration_id` integer, required

## Headers

- `ClientSessionId` string, uuid

## Request body

- union
  - LocalBaserowIntegrationUpdateIntegration
    - `name` string
    - `context_data` LocalBaserowContextData, required
      - `databases` LocalBaserowDatabaseApplication[], required
        - `id` integer, required
        - `name` string, required
        - `order` integer, required
        - `type` string, required
        - `workspace` Workspace, required
          - `id` integer, required
          - `name` string, required
          - `generative_ai_models_enabled` string, required
        - `created_on` string, date-time, required
        - `tables` LocalBaserowTable[], required — This field is specific to the `database` application and contains an array of tables that are in the database.
          - `id` integer, required
          - `database_id` integer, required
          - `name` string, required
          - `is_data_sync` boolean, required — Whether this table is a data synced table or not.
          - `is_two_way_data_sync` boolean, required — Whether this table is a two-way data synced table or not.
        - `views` LocalBaserowView[], required — This field is specific to the `database` application and contains an array of views that are in the tables.
          - `id` integer, required
          - `table_id` integer, required
          - `name` string, required
    - `authorized_user` SubjectUser, required
      - `id` integer, required
      - `username` string, required — Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.
      - `first_name` string, required
      - `email` string, email, required
  - SMTPIntegrationUpdateIntegration
    - `name` string
    - `host` string, required — The SMTP server hostname or IP address.
    - `port` integer — The SMTP server port.
    - `use_tls` boolean — Whether to use TLS encryption.
    - `username` string, nullable — The SMTP username for authentication.
    - `password` string, nullable — The SMTP password for authentication.
  - AIIntegrationUpdateIntegration
    - `name` string
    - `ai_settings` unknown
  - SlackBotIntegrationUpdateIntegration
    - `name` string
    - `token` string, required — The Bot User OAuth Token listed in your Slack bot's OAuth & Permissions page.

## Response `200`

- union
  - LocalBaserowIntegrationIntegration — Basic integration serializer mostly for returned values.
    - `id` integer, required
    - `application_id` integer, required
    - `type` string, required — The type of the integration.
    - `name` string, required
    - `order` string, decimal, required — Lowest first.
    - `context_data` LocalBaserowContextData, required
      - `databases` LocalBaserowDatabaseApplication[], required
        - `id` integer, required
        - `name` string, required
        - `order` integer, required
        - `type` string, required
        - `workspace` Workspace, required
          - `id` integer, required
          - `name` string, required
          - `generative_ai_models_enabled` string, required
        - `created_on` string, date-time, required
        - `tables` LocalBaserowTable[], required — This field is specific to the `database` application and contains an array of tables that are in the database.
          - `id` integer, required
          - `database_id` integer, required
          - `name` string, required
          - `is_data_sync` boolean, required — Whether this table is a data synced table or not.
          - `is_two_way_data_sync` boolean, required — Whether this table is a two-way data synced table or not.
        - `views` LocalBaserowView[], required — This field is specific to the `database` application and contains an array of views that are in the tables.
          - `id` integer, required
          - `table_id` integer, required
          - `name` string, required
    - `authorized_user` SubjectUser, required
      - `id` integer, required
      - `username` string, required — Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.
      - `first_name` string, required
      - `email` string, email, required
  - SMTPIntegrationIntegration — Basic integration serializer mostly for returned values.
    - `id` integer, required
    - `application_id` integer, required
    - `type` string, required — The type of the integration.
    - `name` string, required
    - `order` string, decimal, required — Lowest first.
    - `host` string, required — The SMTP server hostname or IP address.
    - `port` integer — The SMTP server port.
    - `use_tls` boolean — Whether to use TLS encryption.
    - `username` string, nullable — The SMTP username for authentication.
    - `password` string, nullable — The SMTP password for authentication.
  - AIIntegrationIntegration — Basic integration serializer mostly for returned values.
    - `id` integer, required
    - `application_id` integer, required
    - `type` string, required — The type of the integration.
    - `name` string, required
    - `order` string, decimal, required — Lowest first.
    - `ai_settings` unknown
  - SlackBotIntegrationIntegration — Basic integration serializer mostly for returned values.
    - `id` integer, required
    - `application_id` integer, required
    - `type` string, required — The type of the integration.
    - `name` string, required
    - `order` string, decimal, required — Lowest first.
    - `token` string, required — The Bot User OAuth Token listed in your Slack bot's OAuth & Permissions page.

## Other responses

- `400`
- `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)