HttpConnection

Object

_id

name

description

origin

documentationUrl

headerKeys

queryParamKeys

bodyParamKeys

enabled

trusted

Whether an unattended Buzz run may send a GET to this connection without asking first.

createdAt

modifiedAt

createdBy

modifiedBy

ownerId

The current transferable owner of the connection; createdBy is the author and never moves.

authType

Authentication type: 'headers' (default), 'oauth', 'session' (cookie-based login like SAP B1), or 'sftp' (an SFTP server that Buzz snippets read with buzz.sftp; never an HTTP API). Legacy connections without this field are treated as 'headers'.

nativeProvider

Hive-managed OAuth app id when this connection uses a native provider such as Google or Microsoft. Client credentials are not user-supplied.

workspaceId

Workspace this connection belongs to. May be null for legacy connections created before workspace-level sharing.

sharingType

Sharing scope - standard Hive pattern. 'me' = only creator, 'custom' = specific users, 'everyone' = all workspace members. Defaults to 'me' for legacy connections without this field.

sharedWith

User IDs to share with (when sharingType = 'custom'). Empty array for legacy connections without this field.

oauthScopes

oauthAuthorizationUrl

oauthTokenUrl

oauthClientId

Resolved - only visible to creator, from oauthClientInformation

oauthClientSecret

Resolved - only visible to the creator (OAuth stays keyed to createdBy in v1), decrypted from encryptedOauthClientSecret

oauthConnected

Resolved - indicates if the connection creator has connected their OAuth account (OAuth stays keyed to createdBy in v1)

sessionLoginPath

Relative path on origin to POST credentials to (e.g. '/Login').

sessionCookieNames

Cookie names captured from the login response's Set-Cookie header(s) and attached to subsequent requests as a Cookie: header.

sessionLoginBodyKeys

UI-visible keys for the login body. Values are encrypted and not returned.

sftpUsername

Login name on the SFTP server. The password is stored encrypted and never returned.

sftpHostKeyFingerprint

The server's SHA256 host key fingerprint as OpenSSH prints it ('SHA256:' and 43 base64 characters). Every connection checks the server's key against it.