CreateHttpConnectionInput

Input Object

authType

Authentication type: defaults to 'headers' for backward compatibility

description

Description shown to AI for tool selection

documentationUrl

Optional link to API documentation

headers

Headers object containing keys and values (values will be encrypted). Optional when authType is 'headers' if request_secure_input will collect credentials after creation. Example: { "Authorization": "Bearer sk-xxx", "X-Api-Key": "abc123" }

name

Display name for the connection. Buzz uses a slug of this name as the tool id (custom_http_{slug}).

nativeProvider

Hive-managed OAuth app. When set, origin, OAuth URLs, and scopes come from the provider catalog and Hive supplies client credentials.

oauthAuthorizationUrl

oauthClientId

OAuth client credentials and endpoints (when authType = 'oauth')

oauthClientSecret

oauthScopes

oauthTokenUrl

origin

Base URL for the API (e.g., "https://api.satismeter.com "), or sftp://host:port when authType = 'sftp'

sessionCookieNames

sessionLoginBody

sessionLoginPath

Session-auth config (when authType = 'session'). sessionLoginBody is a JSON object of credentials that is encrypted at rest and POSTed to sessionLoginPath; the response's Set-Cookie header is parsed and the cookies named in sessionCookieNames are attached to subsequent requests as a Cookie: header.

sftpHostKeyFingerprint

sftpUsername

SFTP config (required when authType = 'sftp'). The password is never part of this input: call request_secure_input with the field "sftpPassword" after creation.

sharedWith

User IDs to share with (required when sharingType = 'custom')

sharingType

Sharing scope. Defaults to 'me' (only creator) for backward compatibility.