Content

Manage content. Use action=“create” to create new content (requires title, type). Use action=“update” to update existing content (requires content_id). Use action=“list” to get content items with filters.

Input Schema

Parameter	Type	Description
action	string	Action to perform on content. Enum: create, list, update
content_id	string	Content UUID (required for update/get single)
title	string	Content title (required for create)
type	string	Content type: blog_post, video, podcast, social_post, newsletter, case_study, whitepaper, infographic, webinar, ebook, ad, landing_page (required for create)
description	string	Short description or excerpt
status	string	Content status: draft, review, approved, published, archived
segment_id	string	Segment UUID
text	string	Body content / main text
tags	array	Tags for categorization
instructions	string	Instructions for AI content generation or editing
campaign_id	string	Campaign UUID
metadata	object	JSON object. For bulk templates, you may set `placeholders.when_unresolved` to `strip_tokens` or `skip_recipient` (see sendBulkMessages).
site_id	string	Filter by site UUID
user_id	string	Filter by user UUID
search	string	Text search in title, description, text
limit	number	Max results (default 50)
offset	number	Pagination offset

Merge fields in stored content

When text is used for audience sends, prefer canonical tokens: {{lead.name}}, {{lead.first_name}}, {{lead.email}}, {{lead.phone}}, {{lead.position}}, {{lead.company}}, {{lead.notes}}, {{lead.metadata.<path>}}, {{site.name}}. Policy: metadata.placeholders.when_unresolved.

REST Endpoint

Actions map to sub-routes: create → /create, list → /get, update → /update.


POST /api/agents/tools/content/create
POST /api/agents/tools/content/get
POST /api/agents/tools/content/update


POST /api/agents/tools/content/create
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "site_id": "YOUR_SITE_ID",
  "title": "How AI is Changing Sales",
  "type": "blog_post",
  "status": "draft",
  "campaign_id": "CAMPAIGN_UUID"
}

Response:


{
  "success": true,
  "content": { "id": "...", "title": "How AI is Changing Sales" }
}