Content Libraries

// Channel defaults to "default" — single-channel apps can call this bare.
const today = await Amba.content.getToday();
 
// Multi-channel apps pass the channel slug explicitly:
const lessonsToday = await Amba.content.getToday('lessons');

// Channel defaults to "default" here too. `options.limit` caps the page
// size; `options.cursor` is the opaque token returned by a prior
// response's `next_cursor` for pagination.
const items = await Amba.content.getLibrary('default', { limit: 20 });
 
// Subsequent page:
const nextPage = await Amba.content.getLibrary('default', {
  limit: 20,
  cursor: previousResponseNextCursor,
});

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

// 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);

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

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

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

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

1. amba_content_libraries_create({ name: "Daily Affirmations", description: "Positive affirmations delivered daily" })
2. amba_content_items_add({ library_id: "<id from step 1>", 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_content_schedules_create({ library_id: "<id from step 1>", name: "Morning Affirmation", schedule_type: "daily_rotation" })

# 1. Seed v1 — first POST under a fresh key. Auto-seeds at rollout_percent=100.
curl -X POST -H "Authorization: Bearer $DEV_TOKEN" \
  https://api.amba.dev/v1/admin/projects/$PROJECT/content/libraries/$LIB/items/mission_intro/versions \
  -d '{ "body": "Welcome to your mission. Tap to begin." }'
 
# 2. Author v2 — second POST under the same key. Lands at rollout_percent=0
#    (invisible to everyone) so you can review before exposing it.
curl -X POST -H "Authorization: Bearer $DEV_TOKEN" \
  https://api.amba.dev/v1/admin/projects/$PROJECT/content/libraries/$LIB/items/mission_intro/versions \
  -d '{ "body": "Welcome — your first mission is ready. Lets go." }'
 
# 3. Ramp v2: 0 → 10 → 50 → 100. Each PATCH is atomic; users re-bucket
#    deterministically so monitoring is straightforward.
curl -X PATCH -H "Authorization: Bearer $DEV_TOKEN" \
  https://api.amba.dev/v1/admin/projects/$PROJECT/content/libraries/$LIB/items/mission_intro/versions/2 \
  -d '{ "rollout_percent": 10 }'
# … review metrics …
curl -X PATCH .../mission_intro/versions/2 -d '{ "rollout_percent": 50 }'
# … review metrics …
curl -X PATCH .../mission_intro/versions/2 -d '{ "rollout_percent": 100 }'
 
# 4. (Optional) Demote v1 once v2 has been at 100% for a stable period.
curl -X PATCH .../mission_intro/versions/1 -d '{ "rollout_percent": 0 }'
 
# 5. Inspect rollout state at any time.
curl -H "Authorization: Bearer $DEV_TOKEN" \
  https://api.amba.dev/v1/admin/projects/$PROJECT/content/libraries/$LIB/items/mission_intro/versions
# → { "data": [{"version":2,"rollout_percent":100,...},{"version":1,"rollout_percent":0,...}], "total": 2 }

GET /client/content/libraries/:libraryId/keys/:contentKey