Skip to main content
GET
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.view.

Errors

  • HTTP 403: The caller cannot view this Workspace’s rebuilds. Use an identity with rebuild view permission.

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"

Query Parameters

state
enum<string>

Lifecycle of one Provider Pool rebuild queue item. Abort is allowed from APPROVED, BUILDING, READY and FAILED; retry moves FAILED back to APPROVED. Stale is derived from the request time, not stored.

Available options:
PENDING_APPROVAL,
SUPERSEDED,
DECLINED,
APPROVED,
BUILDING,
READY,
SWAPPED,
CLEANED,
FAILED,
ABORTED

Response

Successful response

data
object[]
required
meta
object
required