API reference
Settings
4 endpoints. Click one to see its parameters, fields and an example. Code samples use the region you pick.
GET/v1/settings/aiBring your own AI: connected providers (keys are never shown), usage this month, limits
Bring your own AI: connected providers (keys are never shown), usage this month, limits
Example
curl "https://ca-api.clocklap.com/v1/settings/ai" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
PATCH/v1/settings/aiConnect or replace a provider key (tested first), choose who summarises, set a monthly limit and photo privacy
Connect or replace a provider key (tested first), choose who summarises, set a monthly limit and photo privacy
Body (JSON)
| Name | Type | Description |
|---|---|---|
openai_key | string | |
anthropic_key | string | |
summary_provider | "auto" | "anthropic" | "openai" | |
monthly_limit_minutes | integer or null | |
voice_notes_enabled | boolean | |
strip_location | boolean | |
retention_days | integer or null |
Example
curl -X PATCH "https://ca-api.clocklap.com/v1/settings/ai" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'Responses
200
DELETE/v1/settings/ai/{provider}Remove a provider key
Remove a provider key
Path parameters
| Name | Type | Description |
|---|---|---|
providerrequired | "openai" | "anthropic" |
Example
curl -X DELETE "https://ca-api.clocklap.com/v1/settings/ai/{provider}" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200
POST/v1/settings/ai/testTest the saved keys with a cheap call to each provider
Test the saved keys with a cheap call to each provider
Example
curl -X POST "https://ca-api.clocklap.com/v1/settings/ai/test" \
-H "Authorization: Bearer $CLOCKLAP_API_KEY"Responses
200