Preferences

GET  /v1/cofounder/preferences
PUT  /v1/cofounder/preferences

The preferences row is the single source of truth for how the agent runs for your account. One row per owner_email.

Authentication

All cofounder endpoints require a valid JWT or API key. X-Act-As-Email is ignored — you can only access your own preferences.

GET

curl https://api.appeeky.com/v1/cofounder/preferences -H "X-API-Key: $KEY"

Returns the full row, or null if you’ve never saved preferences:

{
  "data": {
    "id": "uuid",
    "owner_email": "you@example.com",
    "enabled": true,
    "timezone": "Europe/Istanbul",
    "schedule_crons": ["0 8 * * *", "0 20 * * *"],
    "agent_mode": "read",
    "persona_preset": "default",
    "persona_prompt": null,
    "enabled_integrations": ["slack"],
    "auto_approve_types": [],
    "analysis_depth": "standard",
    "briefing_language": "auto",
    "personality_profile": "balanced",
    "public_diary_enabled": false,
    "public_diary_slug": null
  }
}

PUT (upsert)

Send only the fields you want to change. Everything else is preserved.

curl -X PUT https://api.appeeky.com/v1/cofounder/preferences \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "timezone": "Europe/Istanbul",
    "scheduleCrons": ["0 8 * * *"],
    "agentMode": "read",
    "personaPreset": "growth",
    "personalityProfile": "yc_partner",
    "briefingLanguage": "tr",
    "analysisDepth": "standard",
    "enabledIntegrations": ["slack", "notion"],
    "autoApproveTypes": ["asc_review_reply"],
    "publicDiaryEnabled": true
  }'

Field reference

Field	Type	Default	Description
`enabled`	bool	`true`	When false, scheduled runs are skipped
`timezone`	string	`UTC`	IANA timezone, used to evaluate cron in your local time
`scheduleCrons`	string[]	`["0 8 * * ", "0 20 * *"]`	Array of cron expressions evaluated hourly
`agentMode`	`read` \| `write`	`read`	See Modes
`personaPreset`	`default` \| `cfo` \| `growth` \| `pm` \| `aso_specialist`	`default`	Functional focus
`personaPrompt`	string \| null	`null`	Free-form override appended after preset
`personalityProfile`	`balanced` \| `blunt_advisor` \| `friendly_mentor` \| `indie_hacker` \| `pg_analytical` \| `yc_partner`	`balanced`	Voice / tone
`briefingLanguage`	`auto` \| `en` \| `tr` \| `es` \| `de` \| `fr` \| `pt` \| `ja`	`auto`	Language of the briefing prose
`enabledIntegrations`	string[]	`[]`	Subset of `slack`, `linear`, `github`, `webhook`, `notion`, `asc_write`
`autoApproveTypes`	string[]	`[]`	Action types that bypass the review queue
`analysisDepth`	`quick` \| `standard` \| `deep`	`standard`	See Modes
`publicDiaryEnabled`	bool	`false`	Enables Public Founder Diary

The slug is auto-generated the first time you set publicDiaryEnabled: true and never changes after that.

Validation

Invalid personaPreset / analysisDepth / briefingLanguage / personalityProfile values are rejected by the DB CHECK constraint and returned as 500s — make sure your client only sends documented values.
Cron expressions are not validated at write time but are evaluated by the orchestrator hourly. Invalid cron entries are silently ignored.

Get Started

Concepts

Knowledge Base

Capabilities

Integrations

API Reference

Authentication

GET

PUT (upsert)

Field reference

Validation

​Authentication

​GET

​PUT (upsert)

​Field reference

​Validation

Authentication

GET

PUT (upsert)

Field reference

Validation