Content Libraries

Manage and schedule content delivery — daily tips, quotes, articles, and more.

Content libraries let you manage collections of content items (tips, quotes, affirmations, articles) and deliver them to users on a schedule. Great for apps that need daily content rotation.

How it works

Create a content library (e.g., "Daily Motivation", "Workout Tips")
Add content items to the library with text, media, categories, and tags
Create a delivery schedule to control when and how items are delivered
The client SDK fetches today's content or browses the full library

SDK usage

Get today's content

const todayItems = await client.content.getToday();
// Returns items scheduled for delivery today

Browse a library

const items = await client.content.getLibrary('lib_xxx', {
  category: 'fitness',
  limit: 20,
  offset: 0,
});

Get a single item

const item = await client.content.getItem('item_xxx');

Create, update, and delete items from the client

The SDK exposes write endpoints for user-owned content. The server stamps owner_app_user_id from the current session — the caller cannot set it. updateItem and deleteItem return 404 when the target item isn't owned by the current user.

// Create — body is required; title, category, tags, metadata, media_url are optional.
const todo = await client.content.createItem('lib_todos', {
  title: 'Buy milk',
  body: '',
  metadata: { completed: false },
});
 
// Update — any field you pass overwrites. `is_active: false` soft-deletes.
await client.content.updateItem(todo.id, {
  metadata: { completed: true },
});
 
// Hard delete.
await client.content.deleteItem(todo.id);

CreateContentItemInput:

interface CreateContentItemInput {
  title?: string | null;
  body: string;
  media_url?: string | null;
  category?: string | null;
  tags?: string[];
  metadata?: Record<string, unknown>;
}

UpdateContentItemInput:

interface UpdateContentItemInput {
  title?: string | null;
  body?: string;
  media_url?: string | null;
  category?: string | null;
  tags?: string[];
  metadata?: Record<string, unknown>;
  is_active?: boolean;
}

Client API reference

Method	Path	Description
`GET`	`/client/content/today`	Today's scheduled content items.
`GET`	`/client/content/libraries/:id/items`	List items in a library (query: `category`, `limit`, `offset`).
`GET`	`/client/content/items/:id`	Fetch a single item.
`POST`	`/client/content/libraries/:id/items`	Create an item owned by the current user.
`PATCH`	`/client/content/items/:id`	Update an item owned by the current user.
`DELETE`	`/client/content/items/:id`	Delete an item owned by the current user.

Admin API reference

Libraries

Method	Path	Description
`POST`	`/admin/content/libraries`	Create library
`GET`	`/admin/content/libraries`	List libraries with item counts

Items

Method	Path	Description
`POST`	`/admin/content/libraries/:id/items`	Add items to library
`GET`	`/admin/content/libraries/:id/items`	List items (paginated)
`PATCH`	`/admin/content/items/:id`	Update an item
`DELETE`	`/admin/content/items/:id`	Delete an item
`POST`	`/admin/content/libraries/:id/bulk`	Bulk import items

Schedules

Method	Path	Description
`POST`	`/admin/content/schedules`	Create delivery schedule
`GET`	`/admin/content/schedules`	List schedules
`PATCH`	`/admin/content/schedules/:id`	Update schedule

POST /admin/content/libraries/:id/items

Body:

{
  "items": [
    {
      "title": "Stay Consistent",
      "body": "The key to progress isn't perfection — it's consistency.",
      "category": "motivation",
      "tags": ["daily", "mindset"],
      "is_premium": false
    }
  ]
}

Schedule types

Type	Description
`daily_rotation`	Rotates through items one per day
`weekly`	Delivers one item per week
`random`	Picks a random item each delivery
`sequential`	Delivers items in sort order

MCP tools

Tool	Description
`amba_create_content_library`	Create a content library
`amba_add_content_items`	Add items to a library
`amba_create_content_schedule`	Set up a delivery schedule

Example: Daily affirmations

Agent: "Set up a daily affirmation library with 5 items"

1. amba_create_content_library({ name: "Daily Affirmations", description: "Positive affirmations delivered daily" })
2. amba_add_content_items({ library_id: "lib_xxx", items: [
     { body: "I am capable of achieving my goals." },
     { body: "Today I choose joy and gratitude." },
     { body: "I am getting stronger every day." },
     { body: "I deserve success and happiness." },
     { body: "Every day is a fresh start." }
   ]})
3. amba_create_content_schedule({ library_id: "lib_xxx", name: "Morning Affirmation", schedule_type: "daily_rotation" })

Database tables

Table	Purpose
`content_libraries`	Library definitions with name and description
`content_items`	Individual items with body, media, category, tags, premium flag
`content_schedules`	Delivery schedules with type and config
`content_deliveries`	Delivery log tracking which items were delivered when

On this page