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.artifacts.view.

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
namespaceSlug
string
required

An immutable data-catalog segment: parables.{parable_slug}.{plot_slug}

Required string length: 1 - 255
Pattern: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$

Response

Successful response

data
object
required

The live namespace that holds a slug, with every revision that was not removed. A producer that lost its namespace ID uses it to reserve on the same namespace, remove a failed revision, or delete the namespace.

meta
object
required