Your first request

This walkthrough verifies your API token works, then lists the connectors configured in your workspace. You need an API token; see Authentication if you do not have one.

Check who you are

GET /api/users/me returns the user your token belongs to.

curl https://api.askparable.com/api/users/me \
  -H "Authorization: Bearer $PARABLE_API_TOKEN"

Response

{
  "data": {
    "id": "018f2a3b-...",
    "name": "Jordan Rivera",
    "email": "jordan@example.com",
    "status": "ACTIVE",
    "roles": ["..."],
    "timezone": "America/New_York"
  },
  "meta": {
    "requestId": "req_..."
  }
}

A 401 here means the token is wrong or revoked. A 200 with your own user record means authentication is working.

List your configured connectors

Each connector your workspace has set up (GitHub, Jira, Slack, and so on) is a connector instance with a computed sync status.

curl "https://api.askparable.com/api/vendors/tenant-connector-instances" \
  -H "Authorization: Bearer $PARABLE_API_TOKEN"

The response lists every configured instance with its current status, so this one call is enough to build a sync-health check into your own monitoring.

Explore your data catalog

See which tables your workspace has in the data lake, grouped by pool (providers, artifacts, parables, workspace):

curl "https://api.askparable.com/api/catalog/catalog?includeHealth=true" \
  -H "Authorization: Bearer $PARABLE_API_TOKEN"

What the pools hold is covered in Your data lake.

The response envelope

Every endpoint wraps its payload the same way:

Field	Purpose
`data`	The resource or list you asked for.
`meta.requestId`	Unique id for the request. Include it when contacting support.
`meta.totalCount`	Total item count on paginated list responses.
`links`	Pagination links, when applicable.

Every endpoint uses this envelope. Include meta.requestId when you contact support about a specific call.

Getting Started

SDKs

Connectors

Parable Data Engine

The response envelope

Next steps

API Reference

Connectors

​The response envelope

​Next steps

API Reference

Connectors

The response envelope

Next steps