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

Errors

  • PA-AU-001: The Parable or the selected ref or Version was not found. Check the rootRefId, refId and versionId.
  • PA-AU-019: The caller cannot view Report context. Use a Workspace identity with Parable access and the required RACI role.

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

rootRefId
string
required

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

Query Parameters

refId
string

UUID v4 with automatic base62 encoding for client-facing APIs

versionId
string

UUID v4 with automatic base62 encoding for client-facing APIs

plotKey
string

UUID v4 with automatic base62 encoding for client-facing APIs

offset
number<double>
Required range: x >= 0
limit
number<double>
Required range: 1 <= x <= 50

Response

Successful response

data
object
required

One page of a line's runs, newest first: the Refresh menu's list and a Plot's History. The page read sends no history; these come when the menu or History opens.

meta
object
required