Skip to main content
The Caret Public API allows you to programmatically interact with your workspace data, including meetings, summaries, and team members. Our API is built on REST principles and returns JSON responses.

Base URL

All requests should be made to:
https://api.caret.so/v1

Key Features

Authentication

Secure requests using API keys managed in your developer settings.

Granular Scopes

Control access with specific permissions for meetings, folders, and users.

Rate Limiting

Limits designed to support both small teams and large-scale integrations.

Webhooks

Receive real-time notifications for meeting completions and data updates.

Getting Started

1

Create API Key

Go to Developer Settings in your dashboard and generate a new key.
2

Configure Scopes

Select the necessary permissions for your integration (e.g., notes:read).
3

Authenticate

Include your key in the X-API-Key header for every request.

Rate Limits

To ensure platform stability, we enforce workspace-level limits:
  • 100 requests/min for standard endpoints.
  • 20 requests/min for heavy operations (e.g., bulk exports).
Exceeding these limits returns a 429 Too Many Requests error.

Support