Skip to main content
POST
Python SDK

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.connectorrequests.create.

Errors

  • WA-RS-002: An equivalent Provider request already exists. Review the existing request instead of creating a duplicate.

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

Customer-facing connector request types (admin/pipeline fields omitted).

connectorName
string
required

Connector name as requested by the customer (free-form)

Required string length: 2 - 80
notes
string | null

Optional notes or context about the request

Pattern: ^[\s\S]*$

Response

Successful response

data
object
required

Customer-facing view of a connector request. Omits sensitive admin/pipeline fields.

meta
object
required