brains

Add a Brain source

post/api/v1/brains/{brain_id}/sources

Request

  • Base URL: https://api.cadencz.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.cadencz.com/api/v1/brains/{brain_id}/sources
  • Auth: HTTP bearer

Path parameters

brain_idstring required

Request body

kindstring required
namestring required
detailstring
excerptstring
contentstring

Example request

{
  "kind": "text",
  "name": "positioning-notes.txt",
  "detail": "TEXT - pasted notes",
  "excerpt": "Orbit helps founders remember follow-ups.",
  "content": "Full source text to ground generation."
}

Response

Successful Response

idstring required
brain_idstring required
kindstring required
namestring required
detailstring required
statusstring required
excerptstring required
contentstring required
fact_countinteger required
summarystring required
summary_status'ready' | 'fallback' | 'unavailable' required
summary_providerstring nullable required
summary_modelstring nullable required
summary_updated_atstring date-time nullable required
added_atstring date-time required

Example response

{
  "added_at": "2026-07-08T10:30:00Z",
  "brain_id": "brain_123",
  "content": "Orbit helps founders remember follow-ups.",
  "detail": "TEXT - pasted notes",
  "excerpt": "Orbit helps founders remember follow-ups.",
  "fact_count": 3,
  "id": "src_123",
  "kind": "text",
  "name": "positioning-notes.txt",
  "status": "indexed",
  "summary": "Orbit is a CRM that helps founders remember sales follow-ups.",
  "summary_model": "deepseek-v4-flash",
  "summary_provider": "deepseek",
  "summary_status": "ready",
  "summary_updated_at": "2026-07-08T10:30:01Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.