Write Data

Store and update user data in BlueNexus's secure, confidential database. Collections are created automatically on first use, and all data is automatically isolated per user and application.

Create a New Record

Store a new record in a specified collection. Collections are created automatically on first use.

import fetch from "node-fetch";

const memoryData = {
  title: "Morning Workout",
  content: "Completed 30-minute run in the park. Feeling energized!",
  category: "fitness",
  timestamp: "2024-12-15T08:30:00Z",
  tags: ["exercise", "health", "running"],
  mood: "energized",
  schemaUri: "https://example.com/schemas/memory.json", // Optional (see structured data)
};

const response = await fetch(
  "https://api.bluenexus.ai/api/v1/data/memories",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${USER_ACCESS_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(memoryData),
  }
);

const createdRecord = await response.json();

// Example response:
// {
//   "id": "66bd3762c23f9e3f152fb4d1",
//   "title": "Morning Workout",
//   "content": "Completed 30-minute run in the park. Feeling energized!",
//   "category": "fitness",
//   "timestamp": "2024-12-15T08:30:00Z",
//   "tags": ["exercise", "health", "running"],
//   "mood": "energized",
//   "createdAt": "2024-12-15T09:00:00.000Z",
//   "updatedAt": "2024-12-15T09:00:00.000Z"
// }

Optional Schema Validation: Include schemaUri in your request body to validate data against a JSON Schema before storing. See Structured Data for details.

See

Update a Data Record

Update an existing record by its ID. You can update any fields in the record.

import fetch from "node-fetch";

const recordId = "66bd3762c23f9e3f152fb4d1";

const updates = {
  content: "Completed 30-minute run in the park. Feeling energized! Added strength training.",
  tags: ["exercise", "health", "running", "strength"],
  mood: "accomplished",
};

const response = await fetch(
  `https://api.bluenexus.ai/api/v1/data/memories/${recordId}`,
  {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${USER_ACCESS_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(updates),
  }
);

const updatedRecord = await response.json();

// Example response:
// {
//   "id": "66bd3762c23f9e3f152fb4d1",
//   "title": "Morning Workout",
//   "content": "Completed 30-minute run in the park. Feeling energized! Added strength training.",
//   "tags": ["exercise", "health", "running", "strength"],
//   "mood": "accomplished",
//   "updatedAt": "2024-12-15T10:30:00.000Z"
// }

Partial Updates: Only the fields you provide will be updated. Other fields remain unchanged.

See

Best Practices

• Use descriptive, plural collection names (e.g., "memories", "preferences", "notes")

• Include timestamp fields in your data for better tracking

• Use schemaUri for important data to ensure consistency

• Update only the fields that changed to minimize data transfer