Flows

Generate a flow from a natural-language description (AI)

Uses GPT-4o to build a complete flow. Costs 15 AI credits. Returns the generated flow with all nodes and edges.

post/flows/generate

Request

  • Base URL: https://www.sociahive.com/api/v1
  • URL: https://www.sociahive.com/api/v1/flows/generate
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (authorization code, authorization URL /api/oauth/authorize, token URL /api/oauth/token, scopes: flows:write)

Request body

descriptionstring required
account_idstring required

MongoDB ObjectId (24-character hex string)

platform_user_idstring required
platform'instagram' | 'messenger' | 'whatsapp' | 'linkedin' | 'twitter' | 'tiktok' | 'telegram' | 'threads' | 'youtube' | 'bluesky' | 'pinterest' | 'facebook'

Connected-account platform identifier

Example request

{
  "account_id": "507f1f77bcf86cd799439011"
}

Response

Server-sent event stream. Emits progress / flow / error events; it is NOT a JSON flow body.

Changes

No recorded changes to this operation across all 1 revision of this API.