P3Docs
enfr

API Reference — Overview

Programmatic access to the P3Analytica suite.

The P3Analytica suite is exposing public APIs incrementally — one app at a time, as each app's surface stabilizes. This page is the index; per-endpoint pages live under each app's section.

Authentication

All API calls are authenticated with a personal access token, scoped to one organization. Generate tokens at /dashboard/settings/api.

bash
curl https://api.p3analytica.com/v1/me \
  -H "Authorization: Bearer p3_pat_xxx"

Tokens carry the same permissions as the user that minted them, restricted to the org you bound the token to at creation.

Conventions

  • Versioning — v1 is locked. Breaking changes go to v2. Non-breaking additions (new fields, new endpoints) land in v1 and are documented in the changelog.
  • Pagination — cursor-based. ?cursor=...&limit=50. Max limit is 200.
  • Errors — JSON { error: { code, message, details? } }. Standard HTTP status codes.
  • Rate limits — per-token + per-org. Headers: X-RateLimit-Remaining, X-RateLimit-Reset.

Available endpoints

SurfaceStatus
/v1/meComing
/v1/orgsComing
Career OS read endpointsComing next release
Punkto read endpointsPlanned
WebhooksPlanned

This section is a placeholder while the public API stabilizes. Subscribe to the changelog at /changelog to be notified when each surface goes live.

SDKs

A TypeScript SDK (@p3analytica/sdk) ships alongside the v1 API. Python and Go SDKs are planned once the surface area is stable.

Was this page helpful?