Python SDK
import json
import os
from parable_types_web_api import CreateTenantConnectorTapInput
from parable_web_api_sdk import ClientConfig, WebApiSDK
sdk = WebApiSDK(
ClientConfig(
base_url=os.environ["PARABLE_API_URL"],
auth_token=os.environ["PARABLE_API_TOKEN"],
default_headers={"X-Tenant": os.environ["PARABLE_WORKSPACE"]},
)
)
input_data = CreateTenantConnectorTapInput.model_validate(
json.loads("{\"tenantConnectorId\":\"550e8400-e29b-41d4-a716-446655440000\",\"connectorTapId\":\"550e8400-e29b-41d4-a716-446655440000\"}"),
)
result = sdk.tenant_connector_taps.create_tenant_connector_tap(input_data)sdk, err := webapisdk.New(webapisdk.SDKConfig{
BaseURL: os.Getenv("PARABLE_API_URL"),
Auth: &webapisdk.AuthConfig{Token: os.Getenv("PARABLE_API_TOKEN")},
RequestInterceptor: func(ctx context.Context, req *http.Request) error {
req.Header.Set("X-Tenant", os.Getenv("PARABLE_WORKSPACE"))
return nil
},
})
if err != nil {
return err
}
var input webapitypes.CreateTenantConnectorTapInput
if err := json.Unmarshal([]byte(`{"tenantConnectorId":"550e8400-e29b-41d4-a716-446655440000","connectorTapId":"550e8400-e29b-41d4-a716-446655440000"}`), &input); err != nil {
return err
}
result, err := sdk.TenantConnectorTapsNamespace.CreateTenantConnectorTap(ctx, input){
"data": {
"canonicalPersonSource": true,
"connectorTapId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"enabled": true,
"id": "<string>",
"kind": "override",
"name": "<string>",
"tenantConnectorId": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"artifactId": "<string>",
"config": {
"access": {
"roles": [
"principals"
],
"defaultAudience": "source_users"
},
"catalogSlug": "<string>",
"materializedDefault": true,
"selectedFields": [
"<string>"
],
"source": {
"key": {
"columns": [
"<string>"
],
"syntheticField": "<string>"
},
"mode": "replicate",
"table": {
"database": "<string>",
"name": "<string>",
"schema": "<string>"
},
"cursorColumn": "<string>",
"dataKind": "snapshot",
"deduplicateAcrossLoads": true,
"deletionSemantics": "by_absence",
"maxWindowDays": 183,
"refreshLookbackDays": 4503599627370495
},
"storageUri": "<string>",
"systemDisabled": true
},
"description": "<string>",
"enabledSince": "2023-11-07T05:31:56Z",
"outputSchema": {}
},
"meta": {
"requestId": "<string>",
"totalCount": 123
},
"links": {
"first": "<string>",
"last": "<string>",
"next": "<string>",
"prev": "<string>"
}
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}Add a Tap to a Provider connection
Sets up a Tap — one stream of data — on a Provider connection in this Workspace. Anything you leave out is copied from the Provider’s own definition of that Tap.
POST
/
api
/
tenant-connector-taps
/
create-tenant-connector-tap
Python SDK
import json
import os
from parable_types_web_api import CreateTenantConnectorTapInput
from parable_web_api_sdk import ClientConfig, WebApiSDK
sdk = WebApiSDK(
ClientConfig(
base_url=os.environ["PARABLE_API_URL"],
auth_token=os.environ["PARABLE_API_TOKEN"],
default_headers={"X-Tenant": os.environ["PARABLE_WORKSPACE"]},
)
)
input_data = CreateTenantConnectorTapInput.model_validate(
json.loads("{\"tenantConnectorId\":\"550e8400-e29b-41d4-a716-446655440000\",\"connectorTapId\":\"550e8400-e29b-41d4-a716-446655440000\"}"),
)
result = sdk.tenant_connector_taps.create_tenant_connector_tap(input_data)sdk, err := webapisdk.New(webapisdk.SDKConfig{
BaseURL: os.Getenv("PARABLE_API_URL"),
Auth: &webapisdk.AuthConfig{Token: os.Getenv("PARABLE_API_TOKEN")},
RequestInterceptor: func(ctx context.Context, req *http.Request) error {
req.Header.Set("X-Tenant", os.Getenv("PARABLE_WORKSPACE"))
return nil
},
})
if err != nil {
return err
}
var input webapitypes.CreateTenantConnectorTapInput
if err := json.Unmarshal([]byte(`{"tenantConnectorId":"550e8400-e29b-41d4-a716-446655440000","connectorTapId":"550e8400-e29b-41d4-a716-446655440000"}`), &input); err != nil {
return err
}
result, err := sdk.TenantConnectorTapsNamespace.CreateTenantConnectorTap(ctx, input){
"data": {
"canonicalPersonSource": true,
"connectorTapId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"enabled": true,
"id": "<string>",
"kind": "override",
"name": "<string>",
"tenantConnectorId": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"artifactId": "<string>",
"config": {
"access": {
"roles": [
"principals"
],
"defaultAudience": "source_users"
},
"catalogSlug": "<string>",
"materializedDefault": true,
"selectedFields": [
"<string>"
],
"source": {
"key": {
"columns": [
"<string>"
],
"syntheticField": "<string>"
},
"mode": "replicate",
"table": {
"database": "<string>",
"name": "<string>",
"schema": "<string>"
},
"cursorColumn": "<string>",
"dataKind": "snapshot",
"deduplicateAcrossLoads": true,
"deletionSemantics": "by_absence",
"maxWindowDays": 183,
"refreshLookbackDays": 4503599627370495
},
"storageUri": "<string>",
"systemDisabled": true
},
"description": "<string>",
"enabledSince": "2023-11-07T05:31:56Z",
"outputSchema": {}
},
"meta": {
"requestId": "<string>",
"totalCount": 123
},
"links": {
"first": "<string>",
"last": "<string>",
"next": "<string>",
"prev": "<string>"
}
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}{
"detail": "<string>",
"status": 400,
"title": "Bad Request",
"type": "about:blank",
"code": "WA-VL-001",
"details": "<unknown>",
"errors": "<unknown>",
"requestId": "<string>"
}Access
This operation needs a Parable token. An MCP token cannot call it. See Authentication for the kinds of token. Your roles must granttenant.connectors.taps.write.
Errors
WA-TCT-002: The Provider connection belongs to a different Workspace. Use a connection from the current Workspace.WA-TCT-003: The requested Provider Tap was not found. Choose a Tap offered by the selected Provider connection.WA-TCT-015: The Tap does not belong to the selected Provider connection. Select a Tap from the same Provider connection.WA-TCT-006: A Tap with this name already exists on the connection. Choose a unique name or update the existing Tap.WA-TCT-036: The Tap’s catalog tables get the same SQL name as another enabled Tap of this Provider in the Workspace. Rename or disable the other Tap, or change the schema that collides.WA-TCT-035: The output schema changes the Provider Tap’s source permissions annotations. Keep every x-access* value as the Provider Tap declares it.
Authorizations
Headers
Body
application/json
Create a per-workspace override of a platform tap. Required input is the
source instance and the platform data pull. Everything else is optional
and, when omitted, is copied from the platform ConnectorTap. Artifact-derived taps use publishArtifact.
Response
Successful response