Prediction

Send message to flow and get AI response

post

Send a message to your flow and receive an AI-generated response. This is the primary endpoint for interacting with your flows and assistants.Authentication: API key may be required depending on flow settings.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Flow ID - the unique identifier of your flow

Example: your-flow-id

Body

application/jsonmultipart/form-data

questionstringOptional

The question/message to send to the flow

Example: What is artificial intelligence?

streamingbooleanOptional

Enable streaming responses for real-time output

Default: falseExample: false

Responses

200

Successful prediction response

application/json

textstringOptional

The AI-generated response text

Example: Artificial intelligence (AI) is a branch of computer science that focuses on creating systems capable of performing tasks that typically require human intelligence.

jsonobject · nullableOptional

The result in JSON format if available (for structured outputs)

questionstringOptional

The original question/message sent to the flow

Example: What is artificial intelligence?

chatIdstringOptional

Unique identifier for the chat session

Example: chat-12345

chatMessageIdstringOptional

Unique identifier for this specific message

Example: msg-67890

sessionIdstring · nullableOptional

Session identifier for conversation continuity

Example: user-session-123

memoryTypestring · nullableOptional

Type of memory used for conversation context

Example: Buffer Memory

400

Bad Request - Invalid input provided or request format is incorrect

application/json

401

Unauthorized - API key required or invalid

application/json

404

Not Found - Chatflow with specified ID does not exist

application/json

413

Payload Too Large - Request payload exceeds size limits

application/json

422

Validation Error - Request validation failed

application/json

500

Internal Server Error - Flow configuration or execution error

application/json

post

/prediction/{id}

HTTPcURLJavaScriptPython

POST /prediction/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 628

{
  "question": "What is artificial intelligence?",
  "form": {
    "title": "Example",
    "count": 1
  },
  "streaming": false,
  "overrideConfig": {
    "sessionId": "user-session-123",
    "temperature": 0.7,
    "maxTokens": 500,
    "vars": {
      "user_name": "Alice"
    }
  },
  "history": [
    {
      "role": "apiMessage",
      "content": "Hello! I'm an AI assistant. How can I help you today?"
    },
    {
      "role": "userMessage",
      "content": "Hi, my name is Sarah and I'm learning about AI"
    }
  ],
  "uploads": [
    {
      "type": "file",
      "name": "example.png",
      "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAABjElEQVRIS+2Vv0oDQRDG",
      "mime": "image/png"
    }
  ],
  "humanInput": {
    "type": "reject",
    "feedback": "Include more emoji"
  }
}

application/jsonmultipart/form-data

{
  "text": "Artificial intelligence (AI) is a branch of computer science that focuses on creating systems capable of performing tasks that typically require human intelligence.",
  "json": {},
  "question": "What is artificial intelligence?",
  "chatId": "chat-12345",
  "chatMessageId": "msg-67890",
  "sessionId": "user-session-123",
  "memoryType": "Buffer Memory",
  "sourceDocuments": [
    {
      "pageContent": "This is the content of the page.",
      "metadata": {
        "author": "John Doe",
        "date": "2024-08-24"
      }
    }
  ],
  "usedTools": [
    {
      "tool": "Name of the tool",
      "toolInput": {
        "input": "search query"
      },
      "toolOutput": "text"
    }
  ]
}