Primicornis API
Primicornis exposes a version-ready REST API (OpenAPI 3.1) for workspace-scoped CRM operations: dynamic object definitions, records, pipelines, imports, search, and analytics events. Every call is resolved against a workspace you belong to; the API never returns cross-tenant data.
Product shape
| Layer | Role |
|---|---|
| Identity | Amazon Cognito (browser) or Primicornis API tokens (automation) |
| Transport | HTTPS JSON over REST |
| Writes | Validated against Zod/OpenAPI contracts in the API process |
| Storage | PostgreSQL (RDS in production) with row-level workspace isolation |
Base URL
- Local:
http://localhost:3001 - Production:
https://api.primicornis.com
All paths in this portal assume that base unless noted. Future revisions may prefix /v1/...; the gateway and docs are structured so that bump is a routing concern, not a content rewrite.
When to use the API
- Migrations — reconcile HubSpot/Airtable exports with Primicornis objects before you cut over teams.
- Revenue & portfolio ops — keep opportunities, rounds, and founder records aligned with your ledger systems.
- Automation — nightly roll-ups, scoring webhook consumers (roadmap), or internal BI extracts.
Machine-readable spec
GET /openapi.json— canonical spec served by the API.- This developer portal links Swagger Editor from
/referencefor interactive exploration of your publicopenapi.json.
Trust & abuse posture
Tokens are hashed at rest, shown once at mint, and bound to exactly one workspace. Default rate limits and metering hooks are described in Core concepts → Rate limits & errors; production values tighten per plan without changing client integration patterns.