Snapshots

Snapshots are the core data model in NeuralSnap — structured 16-field thought-crystals that capture what you think, why you think it, and how to challenge it. Use these endpoints to create, list, read, update, and delete snapshots in your brain.

Create a Snapshot

POST/api/v1/snapshots

Create a new Neural Snapshot in your brain.

Body Parameters

namestringrequired

Display name for the snapshot.

corestringrequired

The core belief, insight, or principle this snapshot captures.

typeenumdefault: Belief

BeliefModelRuleConvictionPrinciple

Category of the snapshot.

one_linerstring

A concise one-sentence summary of the snapshot.

storystring

The narrative or backstory behind this knowledge.

momentstring

The specific moment or event that formed this insight.

emotionjson

Emotional context as a JSON object (e.g. {"primary": "curiosity", "intensity": 0.8}).

sourcestring

Where this knowledge came from (book, conversation, experience, etc.).

trigger_patternstring

Situations or patterns that activate this knowledge.

methodstring

How to apply this knowledge in practice.

stepsstring

Step-by-step process for applying this insight.

filterstring

When this knowledge applies — and when it doesn't.

challengestring

The strongest counterargument to this belief.

break_teststring

What evidence would make you abandon this belief entirely?

risksstring

Risks or downsides of holding this belief.

proofstring

Evidence or proof that supports this belief.

confidencenumberdefault: 0.5

How confident you are (0–1 scale).

significance_scorenumberdefault: 0.5

How significant this knowledge is to you (0–1 scale).

tagsstring[]

Array of tags for organization and filtering.

bash

curl -X POST https://neuralsnap.ai/api/v1/snapshots \
  -H "Authorization: Bearer ns_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "First Principles Thinking",
    "core": "Break problems down to fundamental truths rather than reasoning by analogy",
    "type": "Model",
    "one_liner": "Reason from the ground up, not from what others have done",
    "story": "Elon Musk applied this to reduce rocket costs by 10x",
    "confidence": 0.9,
    "significance_score": 0.85,
    "tags": ["thinking", "problem-solving", "mental-models"]
  }'

json

{
  "data": {
    "id": "snap_a1b2c3d4e5f6",
    "brain_id": "brain_abc123",
    "name": "First Principles Thinking",
    "core": "Break problems down to fundamental truths rather than reasoning by analogy",
    "type": "Model",
    "one_liner": "Reason from the ground up, not from what others have done",
    "story": "Elon Musk applied this to reduce rocket costs by 10x",
    "moment": null,
    "emotion": null,
    "source": null,
    "trigger_pattern": null,
    "method": null,
    "steps": null,
    "filter": null,
    "challenge": null,
    "break_test": null,
    "risks": null,
    "proof": null,
    "confidence": 0.9,
    "significance_score": 0.85,
    "tags": ["thinking", "problem-solving", "mental-models"],
    "source_type": "manual",
    "source_id": null,
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  }
}

Try it — Create a snapshot

List Snapshots

GET/api/v1/snapshots

Retrieve a paginated list of your snapshots.

Query Parameters

typeenum

BeliefModelRuleConvictionPrinciple

Filter by snapshot type.

limitnumberdefault: 50

Number of snapshots to return (1–100).

offsetnumberdefault: 0

Number of snapshots to skip for pagination.

bash

curl "https://neuralsnap.ai/api/v1/snapshots?type=Model&limit=10" \
  -H "Authorization: Bearer ns_test_abc123"

json

{
  "data": [
    {
      "id": "snap_a1b2c3d4e5f6",
      "brain_id": "brain_abc123",
      "name": "First Principles Thinking",
      "core": "Break problems down to fundamental truths...",
      "type": "Model",
      "one_liner": "Reason from the ground up, not from what others have done",
      "story": null,
      "moment": null,
      "emotion": null,
      "source": null,
      "trigger_pattern": null,
      "method": null,
      "steps": null,
      "filter": null,
      "challenge": null,
      "break_test": null,
      "risks": null,
      "proof": null,
      "confidence": 0.9,
      "significance_score": 0.85,
      "tags": ["thinking", "problem-solving", "mental-models"],
      "source_type": "manual",
      "source_id": null,
      "created_at": "2025-01-15T10:30:00.000Z",
      "updated_at": "2025-01-15T10:30:00.000Z"
    },
    {
      "id": "snap_f6e5d4c3b2a1",
      "brain_id": "brain_abc123",
      "name": "Inversion Thinking",
      "core": "Instead of asking how to succeed, ask what would guarantee failure...",
      "type": "Model",
      "one_liner": null,
      "story": null,
      "moment": null,
      "emotion": null,
      "source": null,
      "trigger_pattern": null,
      "method": null,
      "steps": null,
      "filter": null,
      "challenge": null,
      "break_test": null,
      "risks": null,
      "proof": null,
      "confidence": 0.85,
      "significance_score": 0.7,
      "tags": ["thinking", "decision-making"],
      "source_type": "manual",
      "source_id": null,
      "created_at": "2025-01-14T15:00:00.000Z",
      "updated_at": "2025-01-14T15:00:00.000Z"
    }
  ],
  "count": 2
}

Try it — List your snapshots

type

limit

offset

Get a Snapshot

GET/api/v1/snapshots/:id

Retrieve a single snapshot by its ID.

Path Parameters

idstringrequired

The unique snapshot ID (e.g. snap_a1b2c3d4e5f6).

bash

curl https://neuralsnap.ai/api/v1/snapshots/snap_a1b2c3d4e5f6 \
  -H "Authorization: Bearer ns_test_abc123"

json

{
  "data": {
    "id": "snap_a1b2c3d4e5f6",
    "brain_id": "brain_abc123",
    "name": "First Principles Thinking",
    "core": "Break problems down to fundamental truths rather than reasoning by analogy",
    "type": "Model",
    "one_liner": "Reason from the ground up, not from what others have done",
    "story": "Elon Musk applied this to reduce rocket costs by 10x",
    "moment": null,
    "emotion": null,
    "source": null,
    "trigger_pattern": null,
    "method": null,
    "steps": null,
    "filter": null,
    "challenge": null,
    "break_test": null,
    "risks": null,
    "proof": null,
    "confidence": 0.9,
    "significance_score": 0.85,
    "tags": ["thinking", "problem-solving", "mental-models"],
    "source_type": "manual",
    "source_id": null,
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-15T10:30:00.000Z"
  }
}

Update a Snapshot

PUT/api/v1/snapshots/:id

Update an existing snapshot. All fields are optional — only include what you want to change.

Path Parameters

idstringrequired

The unique snapshot ID.

Body Parameters

namestring

Updated display name.

corestring

Updated core belief or insight.

typeenum

BeliefModelRuleConvictionPrinciple

Updated snapshot type.

one_linerstring

Updated one-liner summary.

storystring

Updated narrative or backstory.

momentstring

Updated origin moment.

emotionjson

Updated emotional context.

sourcestring

Updated knowledge source.

trigger_patternstring

Updated trigger pattern.

methodstring

Updated application method.

stepsstring

Updated application steps.

filterstring

Updated applicability filter.

challengestring

Updated counterargument.

break_teststring

Updated break test.

risksstring

Updated risks.

proofstring

Updated supporting evidence.

confidencenumber

Updated confidence score (0–1).

significance_scorenumber

Updated significance score (0–1).

tagsstring[]

Updated tags (replaces existing tags).

bash

curl -X PUT https://neuralsnap.ai/api/v1/snapshots/snap_a1b2c3d4e5f6 \
  -H "Authorization: Bearer ns_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "confidence": 0.95,
    "challenge": "Sometimes analogies reveal patterns first principles miss",
    "tags": ["thinking", "problem-solving", "mental-models", "updated"]
  }'

json

{
  "data": {
    "id": "snap_a1b2c3d4e5f6",
    "brain_id": "brain_abc123",
    "name": "First Principles Thinking",
    "core": "Break problems down to fundamental truths rather than reasoning by analogy",
    "type": "Model",
    "one_liner": "Reason from the ground up, not from what others have done",
    "story": "Elon Musk applied this to reduce rocket costs by 10x",
    "moment": null,
    "emotion": null,
    "source": null,
    "trigger_pattern": null,
    "method": null,
    "steps": null,
    "filter": null,
    "challenge": "Sometimes analogies reveal patterns first principles miss",
    "break_test": null,
    "risks": null,
    "proof": null,
    "confidence": 0.95,
    "significance_score": 0.85,
    "tags": ["thinking", "problem-solving", "mental-models", "updated"],
    "source_type": "manual",
    "source_id": null,
    "created_at": "2025-01-15T10:30:00.000Z",
    "updated_at": "2025-01-16T08:15:00.000Z"
  }
}

Delete a Snapshot

DELETE/api/v1/snapshots/:id

Permanently delete a snapshot from your brain. This action cannot be undone.

Path Parameters

idstringrequired

The unique snapshot ID.

bash

curl -X DELETE https://neuralsnap.ai/api/v1/snapshots/snap_a1b2c3d4e5f6 \
  -H "Authorization: Bearer ns_test_abc123"

json

{
  "data": {
    "success": true
  }
}

Irreversible

Deletion is permanent. There is no soft-delete or trash. Make sure you have a backup if you might need the snapshot later.

Authentication