Agent Workflow API

# Legacy /manage endpoints remain available for admin/setup automations,
# but they are hidden from default generated tool discovery.
import httpx

headers = {"X-API-Key": "wf_ak_your_key_here"}
base = "https://wordflowsai.com/api/agent"
org_id = 42

# Bootstrap the project and pick a voice first
startup = httpx.get(f"{base}/manage/org/startup-context", headers=headers,
    params={"organization_id": org_id}).json()
voice_id = startup["default_voice_id"]

# Add a new offer
httpx.post(f"{base}/manage/offers", headers=headers,
    params={"organization_id": org_id},
    json={"name": "Pro Plan", "description": "Full access", "offer_type": "product", "price_info": "$49/mo"})

# Update content strategy
httpx.put(f"{base}/manage/org", headers=headers,
    params={"organization_id": org_id},
    json={"content_strategy": "Focus on developer education and cloud-native tutorials"})

# Add knowledge from a URL
httpx.post(f"{base}/manage/materials/from-url", headers=headers,
    params={"organization_id": org_id},
    json={"url": "https://acme.com/about", "title": "About Us", "category": "company_info"})

# Save a preference
httpx.post(f"{base}/manage/memories", headers=headers,
    params={"organization_id": org_id},
    json={"content": "Always mention our free tier in blog posts", "category": "instruction"})

# Inspect the selected voice
voice = httpx.get(f"{base}/manage/voice", headers=headers,
    params={"organization_id": org_id, "voice_id": voice_id}).json()

# Save a topical map drafted in ChatGPT/Codex
httpx.post(f"{base}/manage/content-plans/bulk", headers=headers,
    params={"organization_id": org_id},
    json={
        "plan": {"title": "AI Content Strategy Topical Map", "type": "topical_map"},
        "source": {"type": "chatgpt", "format": "markdown"},
        "items": [{
            "client_id": "pillar-1",
            "title": "AI Content Operations",
            "children": [{"client_id": "cluster-1-1", "title": "How to Build an AI Content Workflow"}]
        }]
    })

print(voice["status"])

{
  "purpose": "write",
  "organization_id": 42,
  "markdown": "## Writing Voice (DNA)\n[Detailed voice instructions tailored to this organization...]\n\n## Style Rules\nGrammar: american_english\nOxford Comma: Yes\n\n## Brand Constraints\nProhibited Words: synergy, leverage, delve"
}

# First, list your projects
curl -H "X-API-Key: wf_ak_your_key_here" \
  https://wordflowsai.com/api/agent/projects

# Then fetch scoped writing context for a project
curl -H "X-API-Key: wf_ak_your_key_here" \
  "https://wordflowsai.com/api/agent/project-context?organization_id=42&purpose=write&topic=ielts%20speaking"

import httpx

headers = {"X-API-Key": "wf_ak_your_key_here"}
base = "https://wordflowsai.com/api/agent"

# Step 0: Get available projects
projects = httpx.get(f"{base}/projects", headers=headers).json()
org_id = projects[0]["id"]

# Step 1: Inspect plans and choose the next item
plans = httpx.get(f"{base}/content-plans", headers=headers, params={"organization_id": org_id}).json()
plan = httpx.get(f"{base}/content-plans/{plans[0]['id']}", headers=headers, params={"organization_id": org_id}).json()
item = next(i for i in plan["items"] if not i.get("content_id"))

# Step 2: Get scoped writing context
ctx = httpx.get(
    f"{base}/project-context",
    headers=headers,
    params={"organization_id": org_id, "purpose": "write", "topic": item["topic"] or item["title"]}
).json()["markdown"]

# Step 3: After the agent writes a whole draft, save it
content = httpx.post(f"{base}/content", headers=headers,
    params={"organization_id": org_id},
    json={"title": item["title"], "markdown": draft_markdown, "content_plan_item_id": item["id"]}).json()

# Step 4: Check the whole draft voice, revise with the LLM, and save again if needed
voice_report = httpx.post(f"{base}/content/{content['content_id']}/draft-voice-check",
    headers=headers, params={"organization_id": org_id}).json()

# Step 5: Run section-aware QA once the whole draft is acceptable
httpx.post(f"{base}/content/{content['content_id']}/quality-pipeline",
    headers=headers, params={"organization_id": org_id}, json={})

import httpx

headers = {"X-API-Key": "wf_ak_your_key_here"}
base = "https://wordflowsai.com/api/agent"

# Get project and visual brand kit before image work
projects = httpx.get(f"{base}/projects", headers=headers).json()
org_id = projects[0]["id"]
kit = httpx.get(f"{base}/image-brand-kit", headers=headers, params={"organization_id": org_id}).json()

# If the agent generated an image, import its ChatGPT file refs
httpx.post(f"{base}/content/{content_id}/attach-chatgpt-image",
    headers=headers,
    params={"organization_id": org_id},
    json={
        "openaiFileIdRefs": [{"download_link": image_download_link, "mime_type": "image/png"}],
        "image_type": "featured",
        "alt_text": "Featured image"
    })