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 one of tenant.providerpolicies.view, tenant.providerpolicies.manage.

Errors

  • WA-PP-007: Parable could not read the access projection. Try again.
  • WA-PP-011: No active member of the Workspace signs in with this email. Enter the email that a member of this Workspace signs in with.
  • WA-PP-012: An explanation says who can open the table’s rows, and your own Policies narrow the table or your roles do not read it with SQL. Ask someone who reads every row of the table to explain it.

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

Asks why one person reads, or does not read, one row of a modeled table.

anchorKey
string
required

The row's value in the table's anchor column.

Required string length: 1 - 4096
email
string<email>
required

An email address

Maximum string length: 255
Pattern: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
providerKey
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})$
tableKey
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})$

Response

Successful response

data
object
required
meta
object
required