ai.reveng.api.ConversationsApi

public class ConversationsApi extends Object

Constructor Summary

Constructors

Constructor

Description

ConversationsApi()

ConversationsApi(ApiClient apiClient)
Method Summary

Modifier and Type

Method

Description

StatusResponse

cancelRun(UUID id)

Cancel an active run Cancels the currently active agentic run for the given conversation.

okhttp3.Call

cancelRunAsync(UUID id, ApiCallback<StatusResponse> _callback)

Cancel an active run (asynchronously) Cancels the currently active agentic run for the given conversation.

okhttp3.Call

cancelRunCall(UUID id, ApiCallback _callback)

Build call for cancelRun

ApiResponse<StatusResponse>

cancelRunWithHttpInfo(UUID id)

Cancel an active run Cancels the currently active agentic run for the given conversation.

StatusResponse

confirmTool(UUID id, ConfirmToolInputBody confirmToolInputBody)

Approve or reject a pending tool confirmation Responds to a pending tool confirmation request.

okhttp3.Call

confirmToolAsync(UUID id, ConfirmToolInputBody confirmToolInputBody, ApiCallback<StatusResponse> _callback)

Approve or reject a pending tool confirmation (asynchronously) Responds to a pending tool confirmation request.

okhttp3.Call

confirmToolCall(UUID id, ConfirmToolInputBody confirmToolInputBody, ApiCallback _callback)

Build call for confirmTool

ApiResponse<StatusResponse>

confirmToolWithHttpInfo(UUID id, ConfirmToolInputBody confirmToolInputBody)

Approve or reject a pending tool confirmation Responds to a pending tool confirmation request.

Conversation

createConversation(CreateConversationRequest createConversationRequest)

Create a new conversation Creates a new conversation for the authenticated user.

okhttp3.Call

createConversationAsync(CreateConversationRequest createConversationRequest, ApiCallback<Conversation> _callback)

Create a new conversation (asynchronously) Creates a new conversation for the authenticated user.

okhttp3.Call

createConversationCall(CreateConversationRequest createConversationRequest, ApiCallback _callback)

Build call for createConversation

ApiResponse<Conversation>

createConversationWithHttpInfo(CreateConversationRequest createConversationRequest)

Create a new conversation Creates a new conversation for the authenticated user.

ApiClient

getApiClient()

ConversationWithEvents

getConversation(UUID id)

Get a conversation with its events Returns the conversation metadata along with all persisted events.

okhttp3.Call

getConversationAsync(UUID id, ApiCallback<ConversationWithEvents> _callback)

Get a conversation with its events (asynchronously) Returns the conversation metadata along with all persisted events.

okhttp3.Call

getConversationCall(UUID id, ApiCallback _callback)

Build call for getConversation

ApiResponse<ConversationWithEvents>

getConversationWithHttpInfo(UUID id)

Get a conversation with its events Returns the conversation metadata along with all persisted events.

String

getCustomBaseUrl()

int

getHostIndex()

List<Conversation>

listConversations()

List conversations for the authenticated user Returns all conversations owned by the authenticated user, ordered by most recently updated.

okhttp3.Call

listConversationsAsync(ApiCallback<List<Conversation>> _callback)

List conversations for the authenticated user (asynchronously) Returns all conversations owned by the authenticated user, ordered by most recently updated.

okhttp3.Call

listConversationsCall(ApiCallback _callback)

Build call for listConversations

ApiResponse<List<Conversation>>

listConversationsWithHttpInfo()

List conversations for the authenticated user Returns all conversations owned by the authenticated user, ordered by most recently updated.

StatusResponse

sendMessage(UUID id, SendMessageRequest sendMessageRequest)

Send a message and start an agentic run Sends a user message to the conversation and kicks off an agentic processing loop in the background.

okhttp3.Call

sendMessageAsync(UUID id, SendMessageRequest sendMessageRequest, ApiCallback<StatusResponse> _callback)

Send a message and start an agentic run (asynchronously) Sends a user message to the conversation and kicks off an agentic processing loop in the background.

okhttp3.Call

sendMessageCall(UUID id, SendMessageRequest sendMessageRequest, ApiCallback _callback)

Build call for sendMessage

ApiResponse<StatusResponse>

sendMessageWithHttpInfo(UUID id, SendMessageRequest sendMessageRequest)

Send a message and start an agentic run Sends a user message to the conversation and kicks off an agentic processing loop in the background.

void

setApiClient(ApiClient apiClient)

void

setCustomBaseUrl(String customBaseUrl)

void

setHostIndex(int hostIndex)

List<ServerSentEventsInner>

streamEvents(UUID id, Long lastEventId)

Stream conversation events (SSE) Opens a Server-Sent Events stream for the given conversation.

okhttp3.Call

streamEventsAsync(UUID id, Long lastEventId, ApiCallback<List<ServerSentEventsInner>> _callback)

Stream conversation events (SSE) (asynchronously) Opens a Server-Sent Events stream for the given conversation.

okhttp3.Call

streamEventsCall(UUID id, Long lastEventId, ApiCallback _callback)

Build call for streamEvents

ApiResponse<List<ServerSentEventsInner>>

streamEventsWithHttpInfo(UUID id, Long lastEventId)

Stream conversation events (SSE) Opens a Server-Sent Events stream for the given conversation.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details
- ConversationsApi
  
  public ConversationsApi()
- ConversationsApi
  
  public ConversationsApi(ApiClient apiClient)

Method Details

getApiClient

public ApiClient getApiClient()
setApiClient

public void setApiClient(ApiClient apiClient)
getHostIndex

public int getHostIndex()
setHostIndex

public void setHostIndex(int hostIndex)
getCustomBaseUrl

public String getCustomBaseUrl()
setCustomBaseUrl

public void setCustomBaseUrl(String customBaseUrl)

cancelRunCall

public okhttp3.Call cancelRunCall(@Nonnull UUID id, ApiCallback _callback) throws ApiException

Build call for cancelRun

Parameters:

id - Conversation UUID (required)

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

cancelRun

public StatusResponse cancelRun(@Nonnull UUID id) throws ApiException

Cancel an active run Cancels the currently active agentic run for the given conversation. Returns 404 if no run is in progress. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `404` [`NO_ACTIVE_RUN`](/errors/NO_ACTIVE_RUN) — No Active Run

Parameters:

id - Conversation UUID (required)

Returns:

StatusResponse

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

cancelRunWithHttpInfo

public ApiResponse<StatusResponse> cancelRunWithHttpInfo(@Nonnull UUID id) throws ApiException

Cancel an active run Cancels the currently active agentic run for the given conversation. Returns 404 if no run is in progress. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `404` [`NO_ACTIVE_RUN`](/errors/NO_ACTIVE_RUN) — No Active Run

Parameters:

id - Conversation UUID (required)

Returns:

ApiResponse<StatusResponse>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

cancelRunAsync

public okhttp3.Call cancelRunAsync(@Nonnull UUID id, ApiCallback<StatusResponse> _callback) throws ApiException

Cancel an active run (asynchronously) Cancels the currently active agentic run for the given conversation. Returns 404 if no run is in progress. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `404` [`NO_ACTIVE_RUN`](/errors/NO_ACTIVE_RUN) — No Active Run

Parameters:

id - Conversation UUID (required)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

confirmToolCall

public okhttp3.Call confirmToolCall(@Nonnull UUID id, @Nonnull ConfirmToolInputBody confirmToolInputBody, ApiCallback _callback) throws ApiException

Build call for confirmTool

Parameters:

id - Conversation UUID (required)

confirmToolInputBody - (required)

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

confirmTool

public StatusResponse confirmTool(@Nonnull UUID id, @Nonnull ConfirmToolInputBody confirmToolInputBody) throws ApiException

Approve or reject a pending tool confirmation Responds to a pending tool confirmation request. The agent pauses before executing certain tools and emits a `TOOL_CONFIRMATION_REQUIRED` event. Use this endpoint to approve or reject the tool call. Returns 404 if no confirmation is pending. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `404` [`NO_PENDING_CONFIRMATION`](/errors/NO_PENDING_CONFIRMATION) — No Pending Confirmation

Parameters:

id - Conversation UUID (required)

confirmToolInputBody - (required)

Returns:

StatusResponse

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

confirmToolWithHttpInfo

public ApiResponse<StatusResponse> confirmToolWithHttpInfo(@Nonnull UUID id, @Nonnull ConfirmToolInputBody confirmToolInputBody) throws ApiException

Approve or reject a pending tool confirmation Responds to a pending tool confirmation request. The agent pauses before executing certain tools and emits a `TOOL_CONFIRMATION_REQUIRED` event. Use this endpoint to approve or reject the tool call. Returns 404 if no confirmation is pending. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `404` [`NO_PENDING_CONFIRMATION`](/errors/NO_PENDING_CONFIRMATION) — No Pending Confirmation

Parameters:

id - Conversation UUID (required)

confirmToolInputBody - (required)

Returns:

ApiResponse<StatusResponse>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

confirmToolAsync

public okhttp3.Call confirmToolAsync(@Nonnull UUID id, @Nonnull ConfirmToolInputBody confirmToolInputBody, ApiCallback<StatusResponse> _callback) throws ApiException

Approve or reject a pending tool confirmation (asynchronously) Responds to a pending tool confirmation request. The agent pauses before executing certain tools and emits a `TOOL_CONFIRMATION_REQUIRED` event. Use this endpoint to approve or reject the tool call. Returns 404 if no confirmation is pending. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `404` [`NO_PENDING_CONFIRMATION`](/errors/NO_PENDING_CONFIRMATION) — No Pending Confirmation

Parameters:

id - Conversation UUID (required)

confirmToolInputBody - (required)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

createConversationCall

public okhttp3.Call createConversationCall(@Nonnull CreateConversationRequest createConversationRequest, ApiCallback _callback) throws ApiException

Build call for createConversation

Parameters:

createConversationRequest - (required)

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
201	Created	-
400	Bad Request	-
422	Unprocessable Entity	-
500	Internal Server Error	-

createConversation

public Conversation createConversation(@Nonnull CreateConversationRequest createConversationRequest) throws ApiException

Create a new conversation Creates a new conversation for the authenticated user. Optionally include a binary analysis context to scope the assistant to a specific analysis. **Error codes:** - `400` [`BAD_REQUEST`](/errors/BAD_REQUEST) — Bad Request

Parameters:

createConversationRequest - (required)

Returns:

Conversation

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
201	Created	-
400	Bad Request	-
422	Unprocessable Entity	-
500	Internal Server Error	-

createConversationWithHttpInfo

public ApiResponse<Conversation> createConversationWithHttpInfo(@Nonnull CreateConversationRequest createConversationRequest) throws ApiException

Create a new conversation Creates a new conversation for the authenticated user. Optionally include a binary analysis context to scope the assistant to a specific analysis. **Error codes:** - `400` [`BAD_REQUEST`](/errors/BAD_REQUEST) — Bad Request

Parameters:

createConversationRequest - (required)

Returns:

ApiResponse<Conversation>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
201	Created	-
400	Bad Request	-
422	Unprocessable Entity	-
500	Internal Server Error	-

createConversationAsync

public okhttp3.Call createConversationAsync(@Nonnull CreateConversationRequest createConversationRequest, ApiCallback<Conversation> _callback) throws ApiException

Create a new conversation (asynchronously) Creates a new conversation for the authenticated user. Optionally include a binary analysis context to scope the assistant to a specific analysis. **Error codes:** - `400` [`BAD_REQUEST`](/errors/BAD_REQUEST) — Bad Request

Parameters:

createConversationRequest - (required)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
201	Created	-
400	Bad Request	-
422	Unprocessable Entity	-
500	Internal Server Error	-

getConversationCall

public okhttp3.Call getConversationCall(@Nonnull UUID id, ApiCallback _callback) throws ApiException

Build call for getConversation

Parameters:

id - Conversation UUID (required)

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

getConversation

public ConversationWithEvents getConversation(@Nonnull UUID id) throws ApiException

Get a conversation with its events Returns the conversation metadata along with all persisted events. Useful for reconstructing the full conversation history on page load. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found

Parameters:

id - Conversation UUID (required)

Returns:

ConversationWithEvents

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

getConversationWithHttpInfo

public ApiResponse<ConversationWithEvents> getConversationWithHttpInfo(@Nonnull UUID id) throws ApiException

Get a conversation with its events Returns the conversation metadata along with all persisted events. Useful for reconstructing the full conversation history on page load. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found

Parameters:

id - Conversation UUID (required)

Returns:

ApiResponse<ConversationWithEvents>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

getConversationAsync

public okhttp3.Call getConversationAsync(@Nonnull UUID id, ApiCallback<ConversationWithEvents> _callback) throws ApiException

Get a conversation with its events (asynchronously) Returns the conversation metadata along with all persisted events. Useful for reconstructing the full conversation history on page load. **Error codes:** - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found

Parameters:

id - Conversation UUID (required)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
200	OK	-
400	Bad Request	-
404	Not Found	-
422	Unprocessable Entity	-
500	Internal Server Error	-

listConversationsCall

public okhttp3.Call listConversationsCall(ApiCallback _callback) throws ApiException

Build call for listConversations

Parameters:

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -
listConversations

public List<Conversation> listConversations() throws ApiException

List conversations for the authenticated user Returns all conversations owned by the authenticated user, ordered by most recently updated.

Returns:

List<Conversation>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -
listConversationsWithHttpInfo

public ApiResponse<List<Conversation>> listConversationsWithHttpInfo() throws ApiException

List conversations for the authenticated user Returns all conversations owned by the authenticated user, ordered by most recently updated.

Returns:

ApiResponse<List<Conversation>>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -
listConversationsAsync

public okhttp3.Call listConversationsAsync(ApiCallback<List<Conversation>> _callback) throws ApiException

List conversations for the authenticated user (asynchronously) Returns all conversations owned by the authenticated user, ordered by most recently updated.

Parameters:

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -

sendMessageCall

public okhttp3.Call sendMessageCall(@Nonnull UUID id, @Nonnull SendMessageRequest sendMessageRequest, ApiCallback _callback) throws ApiException

Build call for sendMessage

Parameters:

id - Conversation UUID (required)

sendMessageRequest - (required)

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
202	Accepted	-
400	Bad Request	-
402	Payment Required	-
403	Forbidden	-
404	Not Found	-
409	Conflict	-
422	Unprocessable Entity	-
500	Internal Server Error	-

sendMessage

public StatusResponse sendMessage(@Nonnull UUID id, @Nonnull SendMessageRequest sendMessageRequest) throws ApiException

Send a message and start an agentic run Sends a user message to the conversation and kicks off an agentic processing loop in the background. Returns immediately with 202 Accepted. Subscribe to `/v2/conversations/{id}/events` via SSE to receive real-time updates including text deltas, tool calls, and run lifecycle events. **Error codes:** - `400` [`BAD_REQUEST`](/errors/BAD_REQUEST) — Bad Request - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `403` [`ACCESS_DENIED`](/errors/ACCESS_DENIED) — Access Denied - `402` [`INSUFFICIENT_CREDITS`](/errors/INSUFFICIENT_CREDITS) — Insufficient Credits - `409` [`RUN_ALREADY_ACTIVE`](/errors/RUN_ALREADY_ACTIVE) — Run Already Active

Parameters:

id - Conversation UUID (required)

sendMessageRequest - (required)

Returns:

StatusResponse

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
202	Accepted	-
400	Bad Request	-
402	Payment Required	-
403	Forbidden	-
404	Not Found	-
409	Conflict	-
422	Unprocessable Entity	-
500	Internal Server Error	-

sendMessageWithHttpInfo

public ApiResponse<StatusResponse> sendMessageWithHttpInfo(@Nonnull UUID id, @Nonnull SendMessageRequest sendMessageRequest) throws ApiException

Send a message and start an agentic run Sends a user message to the conversation and kicks off an agentic processing loop in the background. Returns immediately with 202 Accepted. Subscribe to `/v2/conversations/{id}/events` via SSE to receive real-time updates including text deltas, tool calls, and run lifecycle events. **Error codes:** - `400` [`BAD_REQUEST`](/errors/BAD_REQUEST) — Bad Request - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `403` [`ACCESS_DENIED`](/errors/ACCESS_DENIED) — Access Denied - `402` [`INSUFFICIENT_CREDITS`](/errors/INSUFFICIENT_CREDITS) — Insufficient Credits - `409` [`RUN_ALREADY_ACTIVE`](/errors/RUN_ALREADY_ACTIVE) — Run Already Active

Parameters:

id - Conversation UUID (required)

sendMessageRequest - (required)

Returns:

ApiResponse<StatusResponse>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code	Description	Response Headers
202	Accepted	-
400	Bad Request	-
402	Payment Required	-
403	Forbidden	-
404	Not Found	-
409	Conflict	-
422	Unprocessable Entity	-
500	Internal Server Error	-

sendMessageAsync

public okhttp3.Call sendMessageAsync(@Nonnull UUID id, @Nonnull SendMessageRequest sendMessageRequest, ApiCallback<StatusResponse> _callback) throws ApiException

Send a message and start an agentic run (asynchronously) Sends a user message to the conversation and kicks off an agentic processing loop in the background. Returns immediately with 202 Accepted. Subscribe to `/v2/conversations/{id}/events` via SSE to receive real-time updates including text deltas, tool calls, and run lifecycle events. **Error codes:** - `400` [`BAD_REQUEST`](/errors/BAD_REQUEST) — Bad Request - `400` [`INVALID_CONVERSATION_ID`](/errors/INVALID_CONVERSATION_ID) — Invalid Conversation ID - `404` [`CONVERSATION_NOT_FOUND`](/errors/CONVERSATION_NOT_FOUND) — Conversation Not Found - `403` [`ACCESS_DENIED`](/errors/ACCESS_DENIED) — Access Denied - `402` [`INSUFFICIENT_CREDITS`](/errors/INSUFFICIENT_CREDITS) — Insufficient Credits - `409` [`RUN_ALREADY_ACTIVE`](/errors/RUN_ALREADY_ACTIVE) — Run Already Active

Parameters:

id - Conversation UUID (required)

sendMessageRequest - (required)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code	Description	Response Headers
202	Accepted	-
400	Bad Request	-
402	Payment Required	-
403	Forbidden	-
404	Not Found	-
409	Conflict	-
422	Unprocessable Entity	-
500	Internal Server Error	-

streamEventsCall

public okhttp3.Call streamEventsCall(@Nonnull UUID id, @Nullable Long lastEventId, ApiCallback _callback) throws ApiException

Build call for streamEvents

Parameters:

id - Conversation UUID (required)

lastEventId - Replay events after this ID (optional)

_callback - Callback for upload/download progress

Returns:

Call to execute

Throws:

ApiException - If fail to serialize the request body object

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -
streamEvents

public List<ServerSentEventsInner> streamEvents(@Nonnull UUID id, @Nullable Long lastEventId) throws ApiException

Stream conversation events (SSE) Opens a Server-Sent Events stream for the given conversation. Events include run lifecycle updates, streaming text deltas, tool call progress, and more. Use the `last_event_id` query parameter to replay missed events after a reconnection.

Parameters:

id - Conversation UUID (required)

lastEventId - Replay events after this ID (optional)

Returns:

List<ServerSentEventsInner>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -
streamEventsWithHttpInfo

public ApiResponse<List<ServerSentEventsInner>> streamEventsWithHttpInfo(@Nonnull UUID id, @Nullable Long lastEventId) throws ApiException

Stream conversation events (SSE) Opens a Server-Sent Events stream for the given conversation. Events include run lifecycle updates, streaming text deltas, tool call progress, and more. Use the `last_event_id` query parameter to replay missed events after a reconnection.

Parameters:

id - Conversation UUID (required)

lastEventId - Replay events after this ID (optional)

Returns:

ApiResponse<List<ServerSentEventsInner>>

Throws:

ApiException - If fail to call the API, e.g. server error or cannot deserialize the response body

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -
streamEventsAsync

public okhttp3.Call streamEventsAsync(@Nonnull UUID id, @Nullable Long lastEventId, ApiCallback<List<ServerSentEventsInner>> _callback) throws ApiException

Stream conversation events (SSE) (asynchronously) Opens a Server-Sent Events stream for the given conversation. Events include run lifecycle updates, streaming text deltas, tool call progress, and more. Use the `last_event_id` query parameter to replay missed events after a reconnection.

Parameters:

id - Conversation UUID (required)

lastEventId - Replay events after this ID (optional)

_callback - The callback to be executed when the API call finishes

Returns:

The request call

Throws:

ApiException - If fail to process the API call, e.g. serializing the request body object

Http Response Details

Response Details
Status Code Description Response Headers

200 OK -

0 Error -

Class ConversationsApi

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Details

ConversationsApi

ConversationsApi

Method Details

getApiClient

setApiClient

getHostIndex

setHostIndex

getCustomBaseUrl

setCustomBaseUrl

cancelRunCall

cancelRun

cancelRunWithHttpInfo

cancelRunAsync

confirmToolCall

confirmTool

confirmToolWithHttpInfo

confirmToolAsync

createConversationCall

createConversation

createConversationWithHttpInfo

createConversationAsync

getConversationCall

getConversation

getConversationWithHttpInfo

getConversationAsync

listConversationsCall

listConversations

listConversationsWithHttpInfo

listConversationsAsync

sendMessageCall

sendMessage

sendMessageWithHttpInfo

sendMessageAsync

streamEventsCall

streamEvents

streamEventsWithHttpInfo

streamEventsAsync