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.connectors.rebuilds.approve.

Errors

  • WA-TCT-030: No rebuild with this ID belongs to this Workspace. Check the rebuild ID.
  • WA-TCT-031: The classification hash differs from the rebuild’s. The details carry currentClassificationHash. Read the rebuild again and approve what it now changes.
  • WA-TCT-032: A later change replaced the rebuild. The details carry successorId, null when the change was reverted. Approve the replacing rebuild instead.
  • WA-TCT-033: Another rebuild of the same Tap is in progress. The details carry inProgressRebuildId. Wait for that rebuild to finish.
  • WA-TCT-034: The rebuild is not waiting for approval. The details carry state. Read the rebuild’s state.

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"

Path Parameters

id
string
required

id parameter UUID v4 with automatic base62 encoding for client-facing APIs

Body

application/json

Approve one of this Workspace's Provider Pool rebuilds.

classificationHash
string
required

The item's classificationHash as the approver was shown it. A different hash is refused with the current one.

Required string length: 1 - 200
notBefore
string<date-time> | null

The earliest time the rebuild may start; null starts it as soon as it can.

Response

Successful response

data
object
required

A rebuild of one of this Workspace's Provider Pool taps, waiting for approval or in progress, technical spec 0082 "Provider Pool layouts and rebuilds").

meta
object
required