> ## Documentation Index
> Fetch the complete documentation index at: https://developers.askparable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> The Parable REST API: endpoints, parameters, and a playground.

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](/getting-started/authentication))                                           |
| Format   | JSON request and response bodies                                                                                       |
| Envelope | Responses wrap payloads in `data` / `meta` / `links` ([details](/getting-started/first-request#the-response-envelope)) |

## 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.                                     |