Update per-connection sync settings

Overview

PATCH/integrations/{connectionId}/settingsintegrations

Update per-connection sync settings

Ecosystem-authorized, validated write of the caller-tunable sync settings the sync worker reads (e.g. gmailLabelIds / gmailWindowDays / redditSubreddits / redditKeywords). The owning ecosystem is derived from the connection; the caller must manage it. 404 when absent/deleted; 403 when the caller cannot manage its ecosystem; 400 on an invalid body.

Auth: bearerAuth — calls run as the authenticated user.

Parameters

connectionIdpathstring

Request body

application/json · optional

gmailLabelIdsoptionalstring[]
Gmail label ids to sync (default INBOX).
gmailWindowDaysoptionalinteger
Days of history to sync (default 30, max 366).
redditSubredditsoptionalstring[]
Subreddits to watch (name or r/name; max 50).
redditKeywordsoptionalstring[]
Keywords to match within watched subreddits (max 50).

Example

{
  "gmailLabelIds": [
    "string"
  ],
  "gmailWindowDays": 0,
  "redditSubreddits": [
    "string"
  ],
  "redditKeywords": [
    "string"
  ]
}

Responses

200

Updated sync settings

okboolean
syncSettingsobject

Example

{
  "ok": true,
  "syncSettings": {}
}

400

Problem Details (RFC 9457)

typeoptionalstring
URI identifying the problem type; 'about:blank' when unspecified
titlestring
Short, human-readable summary of the problem type
statusinteger
HTTP status code, duplicated in the body
detailoptionalstring
Explanation specific to this occurrence
instanceoptionalstring
URI reference for this occurrence (the request path)

Example

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

401

Problem Details (RFC 9457)

typeoptionalstring
URI identifying the problem type; 'about:blank' when unspecified
titlestring
Short, human-readable summary of the problem type
statusinteger
HTTP status code, duplicated in the body
detailoptionalstring
Explanation specific to this occurrence
instanceoptionalstring
URI reference for this occurrence (the request path)

Example

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

403

Problem Details (RFC 9457)

typeoptionalstring
URI identifying the problem type; 'about:blank' when unspecified
titlestring
Short, human-readable summary of the problem type
statusinteger
HTTP status code, duplicated in the body
detailoptionalstring
Explanation specific to this occurrence
instanceoptionalstring
URI reference for this occurrence (the request path)

Example

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

404

Problem Details (RFC 9457)

typeoptionalstring
URI identifying the problem type; 'about:blank' when unspecified
titlestring
Short, human-readable summary of the problem type
statusinteger
HTTP status code, duplicated in the body
detailoptionalstring
Explanation specific to this occurrence
instanceoptionalstring
URI reference for this occurrence (the request path)

Example

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

Code examples

cURL

curl -X PATCH "https://api.agenticdeveloperhub.com/integrations/{connectionId}/settings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "gmailLabelIds": [
    "string"
  ],
  "gmailWindowDays": 0,
  "redditSubreddits": [
    "string"
  ],
  "redditKeywords": [
    "string"
  ]
}'

JavaScript

const res = await fetch("https://api.agenticdeveloperhub.com/integrations/{connectionId}/settings", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"gmailLabelIds\": [\n    \"string\"\n  ],\n  \"gmailWindowDays\": 0,\n  \"redditSubreddits\": [\n    \"string\"\n  ],\n  \"redditKeywords\": [\n    \"string\"\n  ]\n}",
});
const data = await res.json();