Skip to main content
POST
Python SDK
Send this request body encrypted with your Workspace’s encryption key. Parable refuses a plain JSON body with 400. See Encrypted request bodies.

Access

This operation needs a Parable token. An MCP token cannot call it. See Authentication for the kinds of token. Your roles must grant tenant.connectors.secrets.

Errors

  • WA-CN-001: The Provider connection was not found. Check the connection identifier.
  • WA-CN-002: The authentication strategy does not belong to this Provider, or authenticationConfig came without authenticationStrategyId. Send one of the Provider’s authentication strategies with its configuration.

Authorizations

Authorization
string
header
required

A personal access token, which starts with pat_. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.

Headers

X-Tenant
string

Workspace slug. Overrides subdomain-based workspace resolution when provided.

Example:

"acme"

X-Request-ID
string<uuid>

Optional request correlation ID echoed back in the response.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
tenantConnectorId
string
required

UUID v4 with automatic base62 encoding for client-facing APIs

Pattern: ^([0-9A-Za-z]{1,22}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
authenticationConfig
object | null

A Parable Schema in JSON

authenticationStrategyId
string | null

UUID v4 with automatic base62 encoding for client-facing APIs

Pattern: ^([0-9A-Za-z]{1,22}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
ingestionConfig
object | null

A Parable Schema in JSON

parentDataFilters
object[] | null

Workspace allowlist: one predicate per parent tap.

Response

Successful response

data
object
required

Result of configuring a connector

meta
object
required