Skip to main content
The Rings AI API exposes tenant data — people, companies, opportunities, notes, tasks, meetings, and relationship intelligence — over a REST interface.

​
Base URL

​
Authentication

All requests require an API key in the x-api-key header. Keys start with the pk_ prefix and are scoped to a single tenant.
See the Quickstart for a walkthrough.

​
Per-user context

Tenant-scoped keys accept an optional x-rings-user-id header. User-scoped keys are permanently bound to a single user.

​
Rate limiting

Both per-second and monthly limits apply. All responses include X-RateLimit-* headers; 429 responses include a Retry-After header.

​
Request correlation

Every response includes an X-Request-Id header. Forward your own request ID by setting the same header on the request.