Developer API
Integrate Itera's goal decomposition AI into your app
Use Itera's first B2B endpoint to turn a high-level goal into a focused 14-day action cycle for coaches, wellness products, and HR platforms.
POST /api/v1/decompose
Authenticate with Authorization: Bearer itera_.... Each key is rate limited to 10 requests per minute.
curl -X POST https://iterai.nanocorp.app/api/v1/decompose \
-H "Content-Type: application/json" \
-H "Authorization: Bearer itera_your_api_key" \
-d '{
"goal": "Learn Spanish in 3 months",
"context": "beginner, 30min/day"
}'JSON response
{
"goal": "Learn Spanish in 3 months",
"actions": [
{
"title": "Schedule 5 weekly study blocks",
"description": "Reserve five 30-minute sessions in your calendar for the next 2 weeks and keep them protected."
},
{
"title": "Complete a beginner lesson every day",
"description": "Finish one guided lesson during each study block and track the completion in your notes app."
},
{
"title": "Practice one speaking drill",
"description": "Record yourself reading basic phrases for 5 minutes after each lesson to improve pronunciation."
}
],
"cycle_length_days": 14,
"first_cycle_actions": [
{
"title": "Schedule 5 weekly study blocks",
"description": "Reserve five 30-minute sessions in your calendar for the next 2 weeks and keep them protected."
},
{
"title": "Complete a beginner lesson every day",
"description": "Finish one guided lesson during each study block and track the completion in your notes app."
},
{
"title": "Practice one speaking drill",
"description": "Record yourself reading basic phrases for 5 minutes after each lesson to improve pronunciation."
}
]
}How to start
- 1. Upgrade to Itera Pro and generate an API key from your dashboard.
- 2. Store the key securely. Itera only returns the raw key once.
- 3. Send partner requests to
POST /api/v1/decomposewith Bearer auth.
Error codes
401 invalid or missing API key, 400 invalid JSON or body shape, 429 rate limit exceeded.