Slugs

A slug is a URL-safe identifier used to route API calls to the correct flow.

Three-Part Hierarchy

Every flow is addressable via three slugs:

/api/v1/seq/{org_slug}/{project_slug}/{flow_slug}/execute

Slug Rules

• Lowercase letters, numbers, and hyphens only
• Cannot start or end with a hyphen
• 2-50 characters
• Must be unique within their scope

Example

Organization: "Acme Corp" → slug: acme-corp Project: "Support Bot" → slug: support-bot Flow: "Classify Intent" → slug: classify-intent

Full URL:

POST https://api.noukai.xyz/api/v1/seq/acme-corp/support-bot/classify-intent/execute

Choosing Good Slugs

• Use descriptive, readable names: translate-and-extract not flow-1
• Keep them stable — changing a slug changes the API URL
• Match your domain language: sentiment-analysis, invoice-parser, email-drafter

Versioned Slugs

Append /v{N} before the action to call a specific version:

POST /api/v1/seq/acme-corp/support-bot/classify-intent/v2/execute
POST /api/v1/seq/acme-corp/support-bot/classify-intent/v3/jobs