GEgetsales
provider_connections

Update provider connection

Rename, pause or resume (status on | off), or rotate the secret: auth_type and auth together replace it in place, same sid, so the tools naming it keep working, and the failure counter resets. Reviving a failed connection (status on) resets it too. A HubSpot grant is not rotatable here (422 oauth_grant_not_client_rotatable: reconnect through the OAuth pair); provider is immutable. At least one field, else 422 nothing_to_update.

Contract:

  • MCP tool update_provider_connection, registry package mcp.integrations/provider_connections, mount integrations.providers.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/provider-connections/{sid}

Request

  • Base URL
    https://beta.getsales.io/integrations/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

Provider connection sid (in_cn_...).

Request body

namestring

New name, 1..255 chars.

status'on' | 'off'

on | off; failed is never client-settable.

auth_type'api_key' | 'bearer' | 'basic' | 'header' | 'query' nullable

With auth: the new secret's shape (the pair rotates together).

authobject

WRITE-ONLY, never echoed: {key} for api_key or bearer, {username, password} for basic, {header_name, value} for header, {param_name, value} for query.

Response

update success envelope.

successtrue required
operation'update' required
updated_fieldsstring[] required
previous_valuesobject required
kept_fieldsstring[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.

Changes

No recorded changes to this operation across all 1 revision of this API.