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. 1. Upgrade to Itera Pro and generate an API key from your dashboard.
  2. 2. Store the key securely. Itera only returns the raw key once.
  3. 3. Send partner requests to POST /api/v1/decompose with Bearer auth.

Error codes

401 invalid or missing API key, 400 invalid JSON or body shape, 429 rate limit exceeded.