API Reference - Parable Developers

The pages in this section document every endpoint of the Parable API. Each page includes parameters, request and response shapes with examples, and a playground for trying calls against your workspace.

Basics


Base URL	`https://api.askparable.com`
Auth	`Authorization: Bearer pat_...` (details)
Format	JSON request and response bodies
Envelope	Responses wrap payloads in `data` / `meta` / `links` (details)

Error handling

Status	Meaning
`400`	Validation failed. The body names the field and the rule it broke. Nothing was applied.
`401`	Missing, malformed, or revoked token.
`403`	The token’s user lacks the permission the endpoint requires.
`404`	The resource does not exist or is outside your workspace.
`429`	Rate limited. Retry after the interval in `Retry-After`.
`5xx`	Something failed on our side. Retry with backoff; include `meta.requestId` values when contacting support.

Endpoint groups

Group	What it covers
Connectors	Configure connectors, run validation, and complete OAuth flows.
Connector taps	Enable, disable, and configure individual data streams.
Vendors	Browse available integrations and monitor configured connector instances.
Catalog	Explore lake tables, freshness, quality results, and lineage.
Artifacts	Upload files, infer schemas, and publish your own tables.
Ingest tokens	Mint scoped tokens for pushing data to collector endpoints.
Users, roles, invitations	Administer workspace membership and permissions.
Query	Workspace query-endpoint information.