Company & App Profiles

GET    /v1/cofounder/company
PATCH  /v1/cofounder/company
PATCH  /v1/cofounder/company/apps/:appId
POST   /v1/cofounder/company/confirm
POST   /v1/cofounder/company/extract
GET    /v1/cofounder/company/preview?appId=…

See Company Knowledge Base for the concepts.

GET /company

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

{
  "data": {
    "company": {
      "companyName": "Appeeky",
      "oneLiner": "Mobile sales analytics for iOS developers",
      "website": "https://appeeky.com",
      "stage": "launched",
      "teamSize": 2,
      "businessModel": "subscription",
      "primaryMarkets": ["US", "TR"],
      "mission": null,
      "companyValues": [],
      "icp": "Indie iOS developers and small studios",
      "positioning": "Developer-grade insight without living in a browser",
      "differentiators": ["Native iOS app", "Paired web dashboard"],
      "brandVoice": "Direct, technical, no exclamation marks",
      "constraints": ["Never recommend removing the free tier"],
      "source": "user",
      "confirmedAt": "2026-07-26T21:14:00Z"
    },
    "appProfiles": [ /* one per app, same shape as PATCH below */ ],
    "isEmpty": false,
    "needsReview": false
  }
}

isEmpty — nothing is filled in, so nothing is injected into runs.
needsReview — an auto-drafted profile with actual content is still unconfirmed. A blank draft doesn’t count, so this never puts a review banner over an empty form.
confirmedAt: null — still a draft. It is injected anyway, flagged low-confidence, but its constraints / doNotTouch rules stay inactive until confirmed.

PATCH /company

Send only the fields you’re changing. An edit counts as confirmation — you just typed it.

curl -X PATCH "https://api.appeeky.com/v1/cofounder/company" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"stage":"scaling","constraints":["Never remove the free tier","No paywall before onboarding"]}'

Field	Type	Notes
`companyName`	string	≤ 200 chars
`oneLiner`	string	≤ 400 chars
`website`	string	Also the crawl seed for auto-drafting
`stage`	enum	`idea` · `pre_launch` · `launched` · `scaling`
`teamSize`	int	Shapes how feasible a proposed action is
`businessModel`	enum	`subscription` · `iap` · `paid` · `ads` · `b2b` · `mixed`
`primaryMarkets`	string[]	Country codes, max 20
`mission`, `icp`, `positioning`, `brandVoice`	string	Prose
`companyValues`, `differentiators`	string[]
`constraints`	string[]	Hard rules. Rendered as blocking; the agent won’t propose actions that break one

Passing null clears a field. An array always replaces — send the full list.

PATCH /company/apps/:appId

curl -X PATCH "https://api.appeeky.com/v1/cofounder/company/apps/6479581124" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"doNotTouch":["app name","the free tier","MX pricing"]}'

Field	Type	Notes
`productOneLiner`	string
`targetUser`	string	May narrow the company ICP
`coreJobs`	string[]	Jobs-to-be-done
`monetization`, `pricingSummary`	string
`keyDifferentiators`	string[]
`knownWeaknesses`	string[]	Stops the agent “discovering” what you already know
`roadmapFocus`	string	This quarter’s bet
`doNotTouch`	string[]	Hard rules for this app

POST /company/confirm

Accepts an auto-draft as-is, without editing it. This is what activates the hard rules.

curl -X POST "https://api.appeeky.com/v1/cofounder/company/confirm" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"appIds":["6479581124"]}'

Confirms the company profile plus every listed app profile. {"confirmed": true} on success.

POST /company/extract

Derives profile fields from business_context.md. Explicit rather than automatic, because it both writes and queues.

curl -X POST "https://api.appeeky.com/v1/cofounder/company/extract" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"appId":"6479581124"}'

{
  "data": {
    "status": "ok",
    "filled":   [{ "field": "icp", "scope": "company" }],
    "proposed": [{ "field": "companyName", "scope": "company" }],
    "unchanged": 4,
    "lowConfidence": 1,
    "rewordsDropped": 2
  }
}

filled — the field was empty, so the value was written straight in.
proposed — the field disagreed, so it became a knowledge patch for you to review.
rewordsDropped — proposals that restated your value with less in it, thrown away rather than queued.
status: "skipped" with a reason when there’s no document or nothing usable in it.

GET /company/preview

The exact text injected into that app’s runs — profiles and pinned documents together, because that’s what the agent actually receives.

curl "https://api.appeeky.com/v1/cofounder/company/preview?appId=6479581124" -H "X-API-Key: $KEY"

{
  "data": {
    "appId": "6479581124",
    "rendered": "## Company\nAppeeky — Mobile sales analytics…",
    "estimatedTokens": 612,
    "profileTokens": 331,
    "libraryTokens": 281,
    "alwaysInjectPaths": ["business_context.md"],
    "isEmpty": false
  }
}

Useful for keeping always-on context under budget: total should stay ≤ 2,500 tokens or it starts displacing the store data the briefing is about.

Documents API — business_context.md and the rest of the Library
Knowledge Patches API — the review queue

Get Started

Concepts

Knowledge Base

Capabilities

Integrations

API Reference

GET /company

PATCH /company

PATCH /company/apps/:appId

POST /company/confirm

POST /company/extract

GET /company/preview

​GET /company

​PATCH /company

​PATCH /company/apps/:appId

​POST /company/confirm

​POST /company/extract

​GET /company/preview

​Related

GET /company

PATCH /company

PATCH /company/apps/:appId

POST /company/confirm

POST /company/extract

GET /company/preview

Related