Quickstart

Sign Up

Go to app.noukai.xyz and sign in with your email. You'll receive a one-time code to verify.

Create Organization and Project

After signing in:

1. Create an organization (your team or company)
2. Within the org, create a project (a workspace for related flows)

Note the slugs — they form your API URL. For example:

• Org slug: acme-corp
• Project slug: support-bot

Build a Flow

Option A: AI-Assisted

Tell Claude Code (or any AI assistant with the prompt file):

"Create a flow called classify-intent that takes a customer message and returns the intent category and confidence score"

Option B: Web UI

In the project dashboard, click "New Flow", add blocks, write prompts, and connect them.

Get Your API Key

Navigate to Project Settings → API Keys → Create Key.

You'll receive a key like:

nk_live_Ab12CdEf_your32charsecrethere1234567890ab

Add it to your .env:

NOUKAI_API_KEY=nk_live_Ab12CdEf_your32charsecrethere1234567890ab

Call Your Flow

curl -X POST https://api.noukai.xyz/api/v1/seq/acme-corp/support-bot/classify-intent/execute \
  -H "Authorization: Bearer $NOUKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "I need to reset my password", "parameters": {}}'

Response:

{
  "status": "completed",
  "result": {
    "intent": "account_recovery",
    "confidence": 0.94
  },
  "flowId": "flow-abc123",
  "blockCount": 1
}