REST API Quick Start: Connect External Apps to AIWU in 10 Minutes

AIWU exposes a REST API that lets external applications trigger AI generation, run workflows, and read data from your WordPress site via HTTP requests. This quick start gets you making your first API call in under 10 minutes — no deep technical background required.

Before You Start

• AIWU Pro with API key configured
• Basic familiarity with HTTP requests (or a tool like Postman, Insomnia, or curl)
• Time needed: ~10 minutes
• Plan required: Pro

Step 1: Generate an API Key

Go to AI Copilot → API → API Keys → Generate New Key. Give it a name (e.g. “My App” or “Zapier”). Set the permission scope:

• Read: GET requests only — retrieve content and data
• Write: POST/PUT requests — create and update content
• Full: Read + Write + Delete — all operations

Copy the key. It won’t be shown again — save it somewhere secure.

Step 2: Your API Base URL

All AIWU API endpoints start with:

https://yoursite.com/wp-json/aiwu/v1/

Replace yoursite.com with your actual domain.

Step 3: Authentication

Include your API key in every request as an HTTP header:

Authorization: Bearer YOUR_API_KEY

Your First API Calls

1. Test the connection (GET):

GET https://yoursite.com/wp-json/aiwu/v1/status
Authorization: Bearer YOUR_API_KEY

Returns: {"status": "ok", "version": "4.9.2", "site": "Your Site Name"}

2. Generate text (POST):

POST https://yoursite.com/wp-json/aiwu/v1/generate
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
"prompt": "Write a 50-word product description for a bamboo cutting board.",
"model": "default",
"max_tokens": 200
}

Returns: {"content": "...", "tokens_used": 85, "model": "gpt-4o-mini"}

3. Trigger a workflow (POST):

POST https://yoursite.com/wp-json/aiwu/v1/workflows/{workflow_id}/trigger
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
"custom_data": {
"product_name": "Bamboo Cutting Board",
"category": "Kitchen"
}
}

Returns: {"triggered": true, "execution_id": "exec_abc123"}

4. Create a WordPress post via API (POST):

POST https://yoursite.com/wp-json/aiwu/v1/posts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
"title": "My New Post",
"content": "Post content here...",
"status": "draft",
"categories": [1, 5]
}

Testing with Postman

Postman is a free tool for testing API calls without writing code.

1. Download Postman from postman.com
2. Create a new request
3. Set the method (GET or POST) and enter the URL
4. Under Headers, add: Key = Authorization, Value = Bearer YOUR_KEY
5. For POST requests: under Body → raw → JSON → paste your JSON payload
6. Click Send

Rate Limits

Hitting rate limits returns a 429 Too Many Requests response. Implement exponential backoff in your application (wait, retry with increasing delays).

Full API Reference

All available endpoints, request formats, and response schemas are documented at: https://yoursite.com/wp-json/aiwu/v1/docs — this auto-generated reference updates automatically with your installed AIWU version.

What’s Next

• 🌐 Use the API in JavaScript: JavaScript API Guide
• 🐘 Use the API in PHP / WordPress themes: PHP Functions & API Reference
• 🔔 Receive event notifications in your app: Webhooks Guide

Last verified: AIWU v.4.9.2 · Updated: 2026-02-25