Skip to main content
POST
/
v1
/
orchestrate
/
runs
/
stream
Chat With Orchestrate Assistant As Stream
curl --request POST \
  --url https://{api_endpoint}/api/v1/orchestrate/runs/stream \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": {
    "role": "<string>",
    "content": [
      {
        "response_type": "conversational_search",
        "json_schema": {},
        "ui_schema": {},
        "form_data": {},
        "id": "<string>",
        "form_operation": "<string>",
        "sub_type": "<string>",
        "event_type": "<string>",
        "dps_payload_id": "<string>"
      }
    ],
    "mentions": [
      {
        "type": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "document_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "parent_message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "additional_properties": {
      "wxa_message": {},
      "display_properties": {
        "skip_render": false,
        "is_async": false,
        "form_operation": ""
      },
      "tool_calls": [
        {}
      ],
      "tool_call_id": "<string>",
      "tool_name": "<string>",
      "wxo_connection_status": {
        "connection_status": "<string>",
        "connection_message": "<string>"
      }
    },
    "assistant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "context": {
      "values": []
    },
    "step_history": [
      {}
    ],
    "message_state": {}
  },
  "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "llm_params": {
    "beam_width": 1,
    "decoding_method": "greedy",
    "include_stop_sequence": true,
    "length_penalty": {
      "decay_factor": 2,
      "start_index": 2
    },
    "max_new_tokens": 1,
    "min_new_tokens": 1,
    "random_seed": 2147483648,
    "repetition_penalty": 1.5,
    "return_options": {
      "generated_tokens": false,
      "input_parameters": true,
      "input_text": false,
      "input_tokens": false,
      "token_logprobs": false,
      "token_ranks": false,
      "top_n_tokens": 2
    },
    "stop_sequences": "[\" and \"]",
    "temperature": 1,
    "time_limit": 123,
    "top_k": 50,
    "top_p": 0.5,
    "truncate_input_tokens": 1,
    "typical_p": 0.505
  },
  "guardrails": {
    "hap": {
      "input": {
        "enabled": false,
        "threshold": 0.5
      },
      "output": {
        "enabled": false,
        "threshold": 0.5
      },
      "mask": {
        "remove_entity_value": false
      }
    },
    "social_bias": {
      "input": {
        "enabled": false,
        "threshold": 0.5
      },
      "output": {
        "enabled": false,
        "threshold": 0.5
      },
      "mask": {
        "remove_entity_value": false
      }
    },
    "pii": {
      "input": {
        "enabled": false,
        "threshold": 0.5
      },
      "output": {
        "enabled": false,
        "threshold": 0.5
      },
      "mask": {
        "remove_entity_value": false
      }
    }
  },
  "context": {},
  "agent_id": "<string>",
  "additional_parameters": {},
  "environment_id": "<string>",
  "version": 123,
  "context_variables": {}
}
'
{
  "id": "<string>",
  "event": "run.started",
  "data": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

stream_timeout
integer
default:60000
multiple_content
boolean
default:false

Body

application/json
message
CreateMessage · object
thread_id
string<uuid> | null
llm_params
TextGenerationParameters · object
guardrails
Guardrails · object
context
Context · object
agent_id
string | null
additional_parameters
Additional Parameters · object
environment_id
string | null
version
integer | null
context_variables
Context Variables · object

Context variables for the agent execution (e.g., {'wxo_email_id': '[email protected]', 'wxo_user_name': 'John Doe'})

Response

Successful Response

id
string
required
event
enum<string>
required
Available options:
run.started,
run.completed,
run.failed,
run.expired,
run.cancelled,
run.step.started,
run.step.completed,
run.step.failed,
run.step.delta,
message.created,
message.started,
message.delta,
message.completed,
run.step.thinking,
message.interrupt,
transcription,
summary,
error,
done,
planning,
flow.slot.listen
data
Data · object
required