Skip to main content
GET
Python SDK

Access

An MCP token or a Parable token can call this operation. See Authentication for the kinds of token. Your roles must grant one of tenant.artifacts.view, tenant.artifacts.upload.

Errors

  • WA-AF-015: The Artifact was not found in this Workspace. Check the artifact identifier and Workspace context.
  • WA-AF-003: Row preview supports CSV Artifacts only. Select a CSV Artifact.
  • WA-AF-017: The Artifact upload is not ready for preview. Wait for the upload to finish, then retry.

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

artifactId
string
required

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

Query Parameters

limit
number<double>

Response

Successful response

data
object
required

Server-side preview of the data backing an artifact, used by the schema editor. The schema describing the row shape is returned alongside the data so consumers can render without a separate fetch.

meta
object
required