---
title: "Callback"
method: POST
path: "/v1/callback/{thread_id}"
tags: ["Orchestrate Assistant"]
---

# Callback

`POST /v1/callback/{thread_id}`

## Path parameters

- `thread_id` string, required

## Request body

- CreateMessage
  - `role` string, required
  - `content` union, required
    - AssistantContent[]
      - `response_type` 'conversational_search' | 'text' | 'image' | 'option' | 'pause' | 'iframe' | 'connect_to_agent' | 'suggestion' | 'channel_transfer' | 'search' | 'user_defined' | 'video' | 'audio' | 'date' | 'inline_error' | 'chat_with_docs_upload' | 'disconnected_apps' | 'forms' | 'form_operation' | 'document_processing_response', required
      - `json_schema` object, nullable
      - `ui_schema` object, nullable
      - `form_data` object, nullable
      - `id` string, nullable
      - `form_operation` string, nullable
      - `sub_type` string, nullable
      - `event_type` string, nullable
      - `dps_payload_id` string, nullable
    - string
  - `mentions` union[], nullable
    - union
      - Mention
        - `type` string, required
        - `id` string, uuid, required
        - `name` string, required
      - AssistantMention
        - `assistant_id` string, uuid, required
        - `assistant_name` string, required
  - `document_ids` string[], nullable
  - `parent_message_id` string, uuid, nullable
  - `additional_properties` AdditionalProperties
    - `wxa_message` object, nullable
    - `display_properties` DisplayProperties
      - `skip_render` boolean
      - `is_async` boolean
      - `form_operation` string
    - `tool_calls` object[], nullable
    - `tool_call_id` string, nullable
    - `tool_name` string, nullable
    - `wxo_connection_status` WxoConnectionStatus
      - `connection_status` string
      - `connection_message` string
  - `assistant_id` string, uuid, nullable
  - `context` Context
    - `values` ContextKV[]
      - `key` string, required
      - `value` unknown
  - `step_history` object[], nullable
  - `message_state` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)