PATCH/destinations/{id}

Update a destination

Requires Bearer authentication. See Authentication.

Request body

type = WEBHOOK

typerequired "WEBHOOK" —

namerequired string —

configrequired WebhookConfig —

urlrequired string (uri) —

method "POST" | "PUT" —

headers object (record) —

timeout number —

signatureMode "HMAC_SHA256" | "BEARER" —

signing WebhookSigningConfig —

`enabled`	boolean	—
`scheme`	"pushrail_v1" \| "github_v1"	—
`header`	string	—

rateLimitPerSecond integer —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = S3

typerequired "S3" —

namerequired string —

configrequired S3Config —

`bucket`required	string	—
`region`required	string	—
`prefix`	string	—
`pathTemplate`	string	—
`fileFormat`	"JSONL" \| "JSON_ARRAY"	—
`compression`	"NONE" \| "GZIP"	—
`rateLimitPerSecond`	integer	—

batchConfigrequired BatchConfig —

`flushIntervalSeconds`	number	—
`maxBatchSize`	number	—
`maxBatchBytes`	number	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret S3Secret —

`accessKeyId`required	string	—
`secretAccessKey`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = GCS

typerequired "GCS" —

namerequired string —

configrequired GCSConfig —

`bucket`required	string	—
`prefix`	string	—
`pathTemplate`	string	—
`fileFormat`	"JSONL" \| "JSON_ARRAY"	—
`compression`	"NONE" \| "GZIP"	—
`rateLimitPerSecond`	integer	—

batchConfigrequired BatchConfig —

`flushIntervalSeconds`	number	—
`maxBatchSize`	number	—
`maxBatchBytes`	number	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

oauthAuthorizationId string (uuid) —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret BigQuerySecret —

serviceAccountKeyrequired string —

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = BIGQUERY

typerequired "BIGQUERY" —

namerequired string —

configrequired BigQueryConfig —

projectIdrequired string —

datasetIdrequired string —

tableIdrequired string —

schemaMappingrequired object —

columnsrequired array —

`sourceField`required	string	—
`columnName`required	string	—
`columnType`required	enum (6)	—
`required`	boolean	—
`defaultValue`	any	—

includeMetadata boolean —

unmappedFieldBehavior "IGNORE" | "STORE_AS_JSON" —

insertMethod "STREAMING" | "LOAD_JOB" —

createTableIfNotExists boolean —

partitionField string —

rateLimitPerSecond integer —

batchConfigrequired BatchConfig —

`flushIntervalSeconds`	number	—
`maxBatchSize`	number	—
`maxBatchBytes`	number	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

oauthAuthorizationId string (uuid) —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret BigQuerySecret —

serviceAccountKeyrequired string —

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = SNOWFLAKE

typerequired "SNOWFLAKE" —

namerequired string —

configrequired SnowflakeConfig —

accountrequired string —

warehouserequired string —

databaserequired string —

schemarequired string —

tablerequired string —

schemaMappingrequired object —

columnsrequired array —

`sourceField`required	string	—
`columnName`required	string	—
`columnType`required	enum (6)	—
`required`	boolean	—
`defaultValue`	any	—

includeMetadata boolean —

unmappedFieldBehavior "IGNORE" | "STORE_AS_JSON" —

loadMethod "STAGE_COPY" | "SNOWPIPE" —

stageNamerequired string —

rateLimitPerSecond integer —

batchConfigrequired BatchConfig —

`flushIntervalSeconds`	number	—
`maxBatchSize`	number	—
`maxBatchBytes`	number	—

authMode enum (25) —

oauthAuthorizationId string (uuid) —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret object —

`username`required	string	—
`password`	string	—
`privateKey`	string	—
`privateKeyPassphrase`	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = POSTHOG

typerequired "POSTHOG" —

namerequired string —

configrequired PosthogConfig —

host string (uri) —

distinctIdField string —

eventNameField string —

timestampField string —

propertiesField string —

groupsMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—

authModerequired "POSTHOG_PROJECT_API_KEY" —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret PosthogSecret —

projectApiKeyrequired string —

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = KINESIS

typerequired "KINESIS" —

namerequired string —

configrequired KinesisConfig —

regionrequired string —

streamNamerequired string —

partitionKeyField string —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret AwsStreamSecret —

`accessKeyId`required	string	—
`secretAccessKey`required	string	—
`sessionToken`	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = SNS

typerequired "SNS" —

namerequired string —

configrequired SnsConfig —

regionrequired string —

topicArnrequired string —

messageGroupIdField string —

messageDeduplicationIdField string —

messageAttributes object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret AwsStreamSecret —

`accessKeyId`required	string	—
`secretAccessKey`required	string	—
`sessionToken`	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = SQS

typerequired "SQS" —

namerequired string —

configrequired SqsConfig —

regionrequired string —

queueUrlrequired string (uri) —

messageGroupIdField string —

messageDeduplicationIdField string —

delaySeconds integer —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret AwsStreamSecret —

`accessKeyId`required	string	—
`secretAccessKey`required	string	—
`sessionToken`	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = PUBSUB

typerequired "PUBSUB" —

namerequired string —

configrequired PubsubConfig —

projectIdrequired string —

topicrequired string —

orderingKeyField string —

attributesMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret BigQuerySecret —

serviceAccountKeyrequired string —

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = KAFKA

typerequired "KAFKA" —

namerequired string —

configrequired KafkaConfig —

brokersrequired string[] —

topicrequired string —

messageKeyField string —

compression enum (5) —

acks "all" | "leader" | "none" —

clientId string —

customHeaders object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret KafkaSecret —

ClickHousePasswordSecret

`username`required	string	—
`password`required	string	—
`caBundlePem`	string	—

KafkaMtlsSecret

`clientCertPem`required	string	—
`clientKeyPem`required	string	—
`caBundlePem`	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = POSTGRES

typerequired "POSTGRES" —

namerequired string —

configrequired PostgresConfig —

hostrequired string —

port integer —

databaserequired string —

schema string —

tablerequired string —

sslMode enum (4) —

columnMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret ClickHouseSecret —

ClickHousePasswordSecret

`username`required	string	—
`password`required	string	—
`caBundlePem`	string	—

ClickHouseMtlsSecret

`username`required	string	—
`clientCertPem`required	string	—
`clientKeyPem`required	string	—
`caBundlePem`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = MYSQL

typerequired "MYSQL" —

namerequired string —

configrequired MySqlConfig —

hostrequired string —

port integer —

databaserequired string —

schemarequired string —

tablerequired string —

sslMode enum (4) —

columnMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret ClickHouseSecret —

ClickHousePasswordSecret

`username`required	string	—
`password`required	string	—
`caBundlePem`	string	—

ClickHouseMtlsSecret

`username`required	string	—
`clientCertPem`required	string	—
`clientKeyPem`required	string	—
`caBundlePem`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = CLICKHOUSE

typerequired "CLICKHOUSE" —

namerequired string —

configrequired ClickHouseConfig —

hostrequired string —

port integer —

databaserequired string —

tablerequired string —

sslMode enum (4) —

format "JSONEachRow" | "JSONCompactEachRow" —

async_insert boolean —

columnMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret ClickHouseSecret —

ClickHousePasswordSecret

`username`required	string	—
`password`required	string	—
`caBundlePem`	string	—

ClickHouseMtlsSecret

`username`required	string	—
`clientCertPem`required	string	—
`clientKeyPem`required	string	—
`caBundlePem`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = AZURE_BLOB

typerequired "AZURE_BLOB" —

namerequired string —

configrequired AzureBlobConfig —

`accountName`required	string	—
`containerName`required	string	—
`prefix`	string	—
`pathTemplate`	string	—
`fileFormat`	"JSONL" \| "JSON_ARRAY"	—
`compression`	"NONE" \| "GZIP"	—
`rateLimitPerSecond`	integer	—

batchConfigrequired BatchConfig —

`flushIntervalSeconds`	number	—
`maxBatchSize`	number	—
`maxBatchBytes`	number	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret AzureConnectionStringSecret | AzureServicePrincipalSecret —

AzureConnectionStringSecret

connectionStringrequired string —

AzureServicePrincipalSecret

`tenantId`required	string (uuid)	—
`clientId`required	string (uuid)	—
`clientSecret`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = AZURE_SERVICE_BUS

typerequired "AZURE_SERVICE_BUS" —

namerequired string —

configrequired AzureServiceBusConfig —

`fullyQualifiedNamespace`required	string	—
`entityType`required	"queue" \| "topic"	—
`entityName`required	string	—
`messageIdField`	string	—
`sessionIdField`	string	—
`partitionKeyField`	string	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret AzureConnectionStringSecret | AzureServicePrincipalSecret —

AzureConnectionStringSecret

connectionStringrequired string —

AzureServicePrincipalSecret

`tenantId`required	string (uuid)	—
`clientId`required	string (uuid)	—
`clientSecret`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = EVENTBRIDGE

typerequired "EVENTBRIDGE" —

namerequired string —

configrequired EventBridgeConfig —

`region`required	string	—
`eventBusName`required	string	—
`defaultSource`required	string	—
`defaultDetailType`required	string	—
`sourceField`	string	—
`detailTypeField`	string	—
`resourcesField`	string	—
`traceHeaderField`	string	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret S3Secret —

`accessKeyId`required	string	—
`secretAccessKey`required	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

type = RABBITMQ

typerequired "RABBITMQ" —

namerequired string —

configrequired object —

`uri`	string	—
`hosts`	string[]	—
`port`	integer	—
`vhost`	string	—
`exchange`	string	—
`routingKey`required	string	—
`routingKeyField`	string	—
`contentType`	string	—
`persistent`	boolean	—
`messageIdField`	string	—
`headersField`	string	—

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

transformConfig object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

secret RabbitMqPlainSecret | RabbitMqMtlsSecret —

RabbitMqPlainSecret

`username`required	string	—
`password`required	string	—
`caCertPem`	string	—

RabbitMqMtlsSecret

`clientCertPem`required	string	—
`clientKeyPem`required	string	—
`caCertPem`	string	—

preflightOverride PreflightOverride —

`status`required	"warn" \| "fail"	—
`reason`required	string	—
`probes`required	string[]	—

Responses

200 200

Field Type Description

idrequired string (uuid) —

namerequired string —

typerequired enum (18) —

statusrequired "ACTIVE" | "DISABLED" | "ARCHIVED" —

environmentrequired "PRODUCTION" | "STAGING" | "DEVELOPMENT" —

WebhookConfig

urlrequired string (uri) —

method "POST" | "PUT" —

headers object (record) —

timeout number —

signatureMode "HMAC_SHA256" | "BEARER" —

signing WebhookSigningConfig —

`enabled`	boolean	—
`scheme`	"pushrail_v1" \| "github_v1"	—
`header`	string	—

rateLimitPerSecond integer —

S3Config

`bucket`required	string	—
`region`required	string	—
`prefix`	string	—
`pathTemplate`	string	—
`fileFormat`	"JSONL" \| "JSON_ARRAY"	—
`compression`	"NONE" \| "GZIP"	—
`rateLimitPerSecond`	integer	—

GCSConfig

`bucket`required	string	—
`prefix`	string	—
`pathTemplate`	string	—
`fileFormat`	"JSONL" \| "JSON_ARRAY"	—
`compression`	"NONE" \| "GZIP"	—
`rateLimitPerSecond`	integer	—

BigQueryConfig

projectIdrequired string —

datasetIdrequired string —

tableIdrequired string —

schemaMappingrequired object —

columnsrequired array —

`sourceField`required	string	—
`columnName`required	string	—
`columnType`required	enum (6)	—
`required`	boolean	—
`defaultValue`	any	—

includeMetadata boolean —

unmappedFieldBehavior "IGNORE" | "STORE_AS_JSON" —

insertMethod "STREAMING" | "LOAD_JOB" —

createTableIfNotExists boolean —

partitionField string —

rateLimitPerSecond integer —

SnowflakeConfig

accountrequired string —

warehouserequired string —

databaserequired string —

schemarequired string —

tablerequired string —

schemaMappingrequired object —

columnsrequired array —

`sourceField`required	string	—
`columnName`required	string	—
`columnType`required	enum (6)	—
`required`	boolean	—
`defaultValue`	any	—

includeMetadata boolean —

unmappedFieldBehavior "IGNORE" | "STORE_AS_JSON" —

loadMethod "STAGE_COPY" | "SNOWPIPE" —

stageNamerequired string —

rateLimitPerSecond integer —

PosthogConfig

host string (uri) —

distinctIdField string —

eventNameField string —

timestampField string —

propertiesField string —

groupsMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—

KinesisConfig

regionrequired string —

streamNamerequired string —

partitionKeyField string —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

SnsConfig

regionrequired string —

topicArnrequired string —

messageGroupIdField string —

messageDeduplicationIdField string —

messageAttributes object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—

SqsConfig

regionrequired string —

queueUrlrequired string (uri) —

messageGroupIdField string —

messageDeduplicationIdField string —

delaySeconds integer —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—

PubsubConfig

projectIdrequired string —

topicrequired string —

orderingKeyField string —

attributesMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

KafkaConfig

brokersrequired string[] —

topicrequired string —

messageKeyField string —

compression enum (5) —

acks "all" | "leader" | "none" —

clientId string —

customHeaders object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

PostgresConfig

hostrequired string —

port integer —

databaserequired string —

schema string —

tablerequired string —

sslMode enum (4) —

columnMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

MySqlConfig

hostrequired string —

port integer —

databaserequired string —

schemarequired string —

tablerequired string —

sslMode enum (4) —

columnMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

ClickHouseConfig

hostrequired string —

port integer —

databaserequired string —

tablerequired string —

sslMode enum (4) —

format "JSONEachRow" | "JSONCompactEachRow" —

async_insert boolean —

columnMapping object (record) —

batchConfig object —

`maxRecords`	integer	—
`flushIntervalMs`	integer	—
`maxBatchBytes`	integer	—

AzureBlobConfig

`accountName`required	string	—
`containerName`required	string	—
`prefix`	string	—
`pathTemplate`	string	—
`fileFormat`	"JSONL" \| "JSON_ARRAY"	—
`compression`	"NONE" \| "GZIP"	—
`rateLimitPerSecond`	integer	—

AzureServiceBusConfig

`fullyQualifiedNamespace`required	string	—
`entityType`required	"queue" \| "topic"	—
`entityName`required	string	—
`messageIdField`	string	—
`sessionIdField`	string	—
`partitionKeyField`	string	—

EventBridgeConfig

`region`required	string	—
`eventBusName`required	string	—
`defaultSource`required	string	—
`defaultDetailType`required	string	—
`sourceField`	string	—
`detailTypeField`	string	—
`resourcesField`	string	—
`traceHeaderField`	string	—

Option 18 · object

`uri`	string	—
`hosts`	string[]	—
`port`	integer	—
`vhost`	string	—
`exchange`	string	—
`routingKey`required	string	—
`routingKeyField`	string	—
`contentType`	string	—
`persistent`	boolean	—
`messageIdField`	string	—
`headersField`	string	—

configVersionrequired number —

transformConfigrequired object —

transformsrequired array —

type = rename

`type`required	"rename"	—
`from`required	string	—
`to`required	string	—

type = drop

`type`required	"drop"	—
`field`required	string	—

type = addStatic

`type`required	"addStatic"	—
`field`required	string	—
`value`	any	—

type = mapPath

`type`required	"mapPath"	—
`from`required	string	—
`to`required	string	—

type = selectFields

`type`required	"selectFields"	—
`fields`required	string[]	—

type = wrap

`type`required	"wrap"	—
`wrapper`required	object (record)	—

transformMode "NONE" | "DECLARATIVE" | "SCRIPT" —

activeTransformScriptId string (uuid) —

deliveryModerequired "REAL_TIME" | "BATCHED" —

batchConfigrequired object —

`flushIntervalSeconds`	number	—
`maxBatchSize`	number	—
`maxBatchBytes`	number	—

customerAccountIdrequired string (uuid) —

customerAccountrequired CustomerAccountRef —

`id`required	string (uuid)	—
`externalId`required	string	—
`name`required	string	—

hasSecretrequired boolean —

authModerequired enum (25) —

authConfigrequired object | AwsAssumeRoleAuthConfig | AwsAssumeRoleAutomatedAuthConfig —

Option 1 · object

No fields.

AwsAssumeRoleAuthConfig

roleArnrequired string —

AwsAssumeRoleAutomatedAuthConfig

awsAccountIdrequired string —

permissionAuditAtrequired string (date-time) —

permissionAuditResultrequired object —

`status`required	"clean" \| "over_privileged" \| "error"	—
`checkedAt`required	string (date-time)	—
`extraPermissions`required	string[]	—
`probeErrors`	string[]	—

preflightLastStatus enum (4) —

preflightLastRanAt string (date-time) —

preflightOverriddenAt string (date-time) —

preflightOverrideReason string —

createdAtrequired string (date-time) —

updatedAtrequired string (date-time) —

credential object —

`id`required	string (uuid)	—
`type`required	string	—
`providerAccountEmail`	string	—
`scopes`	string[]	—
`oauthAuthorizationId`	string (uuid)	—
`status`	string	—
`expiresAt`	string (date-time)	—

createdSigningSecret string —

404 404

Field Type Description

errorrequired object —

`code`required	string	—
`message`required	string	—
`details`	any	—

Errors

Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.