Skip to main content
PUT
/
api
/
integrations
/
v1
/
{integration_id}
UpdateIntegration
curl --request PUT \
  --url https://developer.synq.io/api/integrations/v1/{integration_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {
    "athena": {
      "accessKey": {
        "accessKeyId": "<string>",
        "secretAccessKey": "<string>"
      },
      "region": "<string>",
      "workgroup": "<string>",
      "useShowCreateTable": true,
      "useShowCreateView": true,
      "fetchQueryLogs": true,
      "useIcebergMetricsScan": true,
      "scope": {
        "include": [
          {
            "database": "<string>",
            "schema": "<string>",
            "table": "<string>"
          }
        ],
        "exclude": [
          {
            "database": "<string>",
            "schema": "<string>",
            "table": "<string>"
          }
        ]
      }
    }
  },
  "title": "<string>",
  "etag": "<string>"
}
'
{
  "integration": {
    "id": "<string>",
    "title": "<string>",
    "disabled": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "etag": "<string>",
    "config": {
      "athena": {
        "accessKey": {
          "accessKeyId": "<string>",
          "secretAccessKey": "<string>"
        },
        "region": "<string>",
        "workgroup": "<string>",
        "useShowCreateTable": true,
        "useShowCreateView": true,
        "fetchQueryLogs": true,
        "useIcebergMetricsScan": true,
        "scope": {
          "include": [
            {
              "database": "<string>",
              "schema": "<string>",
              "table": "<string>"
            }
          ],
          "exclude": [
            {
              "database": "<string>",
              "schema": "<string>",
              "table": "<string>"
            }
          ]
        }
      }
    },
    "outputs": {
      "athena": {
        "accountId": "<string>",
        "principalArn": "<string>"
      }
    },
    "capabilities": {
      "canPatch": true,
      "canRefresh": true,
      "canDisable": true,
      "canEnable": true,
      "canDelete": true
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
integration_id
string<uuid>
required

Id of the integration to update (UUID).

Body

application/json

Request to update an integration. The config is replaced wholesale; title is patch-style (omit to leave unchanged).

​
config
athena · object
required

New connection configuration. The populated config variant must match the existing integration's type.

​
title
string | null

New human-friendly name. Omit to leave the title unchanged.

Required string length: 1 - 255
​
etag
string | null

Optional optimistic-concurrency guard. When set, the update is applied only if it matches the integration's current etag; otherwise ABORTED (HTTP 409). Omit for last-write-wins.

Response

200 - application/json

Success

Response from updating an integration.

​
integration
Integration · object

The updated integration with a new etag.