SnozeDevelopers
API referenceIntegrations

Update the sync state of one provider object type

Enables or disables a single provider object type on a connection and replaces its field mappings, returning the refreshed connection detail. Requires the `integrations:write` workspace permission. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.

PATCH
/v1/workspaces/{workspaceId}/integrations/connections/{connectionId}/objects/{objectKey}

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string
connectionId*string
objectKey*string

Request Body

application/json
  1. body
enabled?boolean|null
fieldMappings?array<>|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X PATCH 'https://api.snoze.dev/v1/workspaces/string/integrations/connections/string/objects/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "data": {    "connection": {      "id": "string",      "workspaceId": "string",      "provider": "string",      "key": "string",      "label": "string",      "enabled": true,      "authKind": "api_key",      "hasSecret": true,      "externalAccountId": "string",      "health": "unknown",      "consecutiveFailures": 0,      "lastSuccessfulSyncAt": "string",      "lastFailureAt": "string",      "lastError": "string",      "nextSyncAt": "string",      "manifest": {},      "createdByUserId": "string",      "createdAt": "string",      "updatedAt": "string"    },    "provider": {      "provider": "string",      "label": "string",      "category": "string",      "authKinds": [        "api_key"      ],      "capabilities": [        "string"      ],      "installKind": "github_app",      "credentialScope": "installation",      "enabled": true,      "configured": true,      "installFields": [        {          "key": "string",          "label": "string",          "required": true,          "placeholder": "string",          "secret": true        }      ],      "docsUrl": "string",      "experience": "deep"    },    "objects": [      {        "objectKey": "string",        "label": "string",        "enabled": true,        "databaseId": "string",        "fields": [          {            "key": "string",            "label": "string",            "kind": "text",            "excluded": true          }        ],        "lastSnapshotAt": "string",        "lastRunAt": "string",        "nextRunAt": "string",        "failureCount": 0,        "fieldMappings": [          {            "key": "string",            "label": "string",            "kind": "text",            "excluded": true,            "options": [              {                "key": "string",                "name": "string",                "color": "string"              }            ]          }        ]      }    ],    "recentRuns": [      {        "id": "string",        "workspaceId": "string",        "connectionId": "string",        "dataSourceId": "string",        "provider": "string",        "status": "running",        "trigger": "string",        "cursorBefore": "string",        "cursorAfter": "string",        "stats": {},        "error": "string",        "startedAt": "string",        "completedAt": "string"      }    ],    "grantedScopes": [      "string"    ]  }}

Read a connection with its per-object sync state

Returns the connection together with the state of each provider object type it can mirror — whether the object is enabled and how its fields map onto native fields. Requires the `integrations:read` workspace permission; credentials are not included.

List the tools exposed by a remote MCP connection

Queries the connection's remote MCP server for its tool list and returns the tools with their input schemas, filtered by the allowlist stored on the connection. Requires the `integrations:read` workspace permission; a server that cannot be reached or that answers with an error surfaces as a remote MCP failure.