Skip to main content
The Go client is github.com/parable-platform/platform-schemas/sdk/go/web-api. It covers every operation in the API reference.

Install

The module is in a private Go module proxy. Ask your Parable representative for access. Then add the client and its types:

Import and authenticate

Create a client with the base URL, your token, and your Workspace. See Authentication to get a token.
The client sends Authorization: Bearer ... on every call. The RequestInterceptor adds the X-Tenant header.

Read

Read your membership, then the Provider connections in your Workspace:

Update

Stop a Tap. This call needs a Parable token, because an MCP token only reads. Replace the ID with one from your Workspace. List Taps with sdk.TenantConnectorTapsNamespace.TenantConnectorTaps(ctx, nil).
The update leaves omitted fields unchanged. enabled: false stops the Tap. enabled: true does not add a Tap that the connection’s enabledTaps leaves out. To turn on an opt-in Tap, see Turn Taps on and off.

Encrypt credentials

Two operations take an encrypted body, such as sdk.ConnectorsNamespace.AddConnectorToTenant. Get your Workspace’s public key and give it to the client once. The client then encrypts the body of each of these operations:
You can also set Encryption: &webapisdk.EncryptionConfig{PublicEncryptionKey: ...} in SDKConfig, or pass &webapisdk.EncryptedRequestOptions{PublicEncryptionKey: ...} to one call. See Encrypted request bodies.

Handle errors and retries

The client gives each request 30 seconds. Set Timeout in milliseconds in SDKConfig to change it. The client retries a request that gets 429 up to 3 times. It waits for the seconds in the Retry-After header, or 1, 2, and 4 seconds when the header is absent, and never more than 300 seconds. Set MaxRateLimitRetries in SDKConfig to change the count. A pointer to 0 turns the retries off. The client does not retry other failures. Each failure is one of these error types: When the API refuses the input with 400, ValidationErrors holds the refused fields and the rule each one failed, in the same shape as the Errors of a *ValidationError. It is nil when the answer names no field. errors.As finds the *APIError inside a 401, 403, or 429 error. A *NetworkError is not an *APIError, so check for it first:
Each operation page in the API reference shows the Go call for that operation, such as sdk.UsersNamespace.Me(ctx).
For table data, use SQL. See Parable Data Engine.