Connections

Update Connection

Changed on

Rename a connection or change its non-interactive opt-in without re-authorizing.

Anyone who may write the connection may withdraw the opt-in. Granting it widens which executions reach the owner's account, so only the owner (a superuser, for an instance connection) may turn it on.

patch/api/v1/connections/{connection_id}

Request

  • The document declares no server URL.
  • Auth
    • OAuth 2
      Password
      Token URL: api/v1/login
    • or API key in query parameter x-api-key
    • or API key in header x-api-key

Path parameters

connection_idstring uuid required

Request body

allow_non_interactiveboolean nullable
display_namestring nullable

Response

Successful Response

allow_non_interactiveboolean required
created_atstring date-time required
display_namestring required
granted_scopesstring[] required
has_credentialsboolean required
health'unknown' | 'healthy' | 'unhealthy' required
health_checked_atstring date-time nullable required
idstring uuid required
namestring required
owner_idstring uuid nullable required
ownership_mode'user' | 'instance' required
provider_keystring required
status'pending' | 'ready' | 'expired' | 'revoked' | 'error' required
status_reason'credential-missing' | 'credential-undecryptable' | 'oauth-denied' | 'oauth-expired' | 'oauth-failed'

A credential error or the result of the most recent failed OAuth attempt.

updated_atstring date-time required

Changes