Documents (Library)

GET     /v1/cofounder/documents?appId=&department=
GET     /v1/cofounder/documents/search?q=&appId=&limit=
GET     /v1/cofounder/documents/content?path=
GET     /v1/cofounder/documents/revisions?id=
PUT     /v1/cofounder/documents
PATCH   /v1/cofounder/documents
DELETE  /v1/cofounder/documents?path=
POST    /v1/cofounder/documents/seed

See Library for the conceptual overview.

GET /documents

Tree listing — metadata only, no bodies.

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

{
  "data": {
    "count": 2,
    "documents": [
      {
        "id": "uuid",
        "path": "business_context.md",
        "title": "Business context",
        "kind": "business_context",
        "department": null,
        "appId": null,
        "visibility": "agents",
        "alwaysInject": true,
        "size": 956,
        "revision": 3,
        "updatedAt": "2026-07-27T16:12:00Z"
      },
      {
        "id": "uuid",
        "path": "growth/paywall-tests.md",
        "title": "Paywall tests",
        "kind": "department",
        "department": "growth",
        "appId": "6479581124",
        "visibility": "agents",
        "alwaysInject": false,
        "size": 2140,
        "revision": 7,
        "updatedAt": "2026-07-25T09:40:00Z"
      }
    ]
  }
}

Param	Notes
`appId`	Filter to one app’s documents
`department`	One of `general`, `engineering`, `design`, `marketing`, `growth`, `aso`, `product`, `sales`, `support`, `finance`, `legal`, `research`

appId: null means every app’s briefings read it. An id means only that app’s do. This is the owner’s own view, so private documents are included. Retrieval and every agent-facing path exclude them.

GET /documents/search

Semantic search (pgvector) with an ilike fallback. Returns snippets, not bodies — a five-result search shouldn’t cost five full documents.

curl "https://api.appeeky.com/v1/cofounder/documents/search?q=paywall+placement&limit=5" \
  -H "X-API-Key: $KEY"

{
  "data": {
    "count": 1,
    "results": [
      {
        "path": "growth/paywall-tests.md",
        "title": "Paywall tests",
        "department": "growth",
        "appId": "6479581124",
        "similarity": 0.842,
        "snippet": "We tested a hard paywall on first launch in March…",
        "truncated": true
      }
    ]
  }
}

limit defaults to 6, max 20. Snippets cut at 600 characters. Matching is cross-lingual — a Turkish query can hit an English document.

GET /documents/content

Full body plus the last 10 revisions (metadata only).

curl "https://api.appeeky.com/v1/cofounder/documents/content?path=business_context.md" \
  -H "X-API-Key: $KEY"

404 when there’s no document at that path.

PUT /documents

Create or overwrite by path. Writes a revision authored user.

curl -X PUT "https://api.appeeky.com/v1/cofounder/documents" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{
    "path": "growth/paywall-tests.md",
    "content": "# Paywall tests\n\n## March 2026\n…",
    "title": "Paywall tests",
    "appId": "6479581124"
  }'

Field	Required	Notes
`path`	Yes	Relative, max 6 segments, no `..`. `.md` is appended when missing
`content`	Yes	Max 200,000 chars
`title`	No	Defaults to the first heading
`appId`	No	`null` = every app
`department`	No	Inferred from the first path segment
`visibility`	No	`agents` (default) · `private` · `public`
`alwaysInject`	No	Max 3 across the workspace → `LIMIT_REACHED`

Content is re-embedded only when it actually changed, so renaming a title doesn’t cost an embedding call.

PATCH /documents

Metadata only — scope, visibility, pin, title. Never touches the body and doesn’t bump the revision.

curl -X PATCH "https://api.appeeky.com/v1/cofounder/documents" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"path":"growth/paywall-tests.md","appId":null,"alwaysInject":false}'

Use this rather than PUT when you’re only flipping a flag. PUT would need the body, and sending a stale one overwrites whatever was typed since you read it.

DELETE /documents

curl -X DELETE "https://api.appeeky.com/v1/cofounder/documents?path=growth/paywall-tests.md" \
  -H "X-API-Key: $KEY"

Removes the document and its revisions. Facts the agent already derived from it stay in the Vault.

POST /documents/seed

Idempotent. Creates business_context.md (pinned, as a heading skeleton) and AGENTS.md if they don’t exist.

{ "data": { "created": ["business_context.md", "AGENTS.md"], "seeded": true } }

seeded: false means both already existed.

Protected paths

business_context.md and AGENTS.md are read-only to the agent’s write_document tool — it has to propose a patch. Over this REST API and over MCP (behind confirm_owner_document) they’re writable, since the caller is you.

Library — scope, pinning, retrieval, and the agent’s tools
Company API — the structured profile fields
Knowledge Patches API — proposed changes to protected documents

Get Started

Concepts

Knowledge Base

Capabilities

Integrations

API Reference

GET /documents

GET /documents/search

GET /documents/content

PUT /documents

PATCH /documents

DELETE /documents

POST /documents/seed

Protected paths

​GET /documents

​GET /documents/search

​GET /documents/content

​PUT /documents

​PATCH /documents

​DELETE /documents

​POST /documents/seed

​Protected paths

​Related

GET /documents

GET /documents/search

GET /documents/content

PUT /documents

PATCH /documents

DELETE /documents

POST /documents/seed

Protected paths

Related