Constructor Detail

Method Detail

• create

   CompletableFuture<MessageBatch> create(MessageBatchCreateParams params, RequestOptions requestOptions)

  Send a batch of Message creation requests.

  The Message Batches API can be used to process multiple Messages API requests at once. Once a Message Batch is created, it begins processing immediately. Batches can take up to 24 hours to complete.

• retrieve

   CompletableFuture<MessageBatch> retrieve(MessageBatchRetrieveParams params, RequestOptions requestOptions)

  This endpoint is idempotent and can be used to poll for Message Batch completion. To access the results of a Message Batch, make a request to the results_url field in the response.

• list

   CompletableFuture<MessageBatchListPageAsync> list(MessageBatchListParams params, RequestOptions requestOptions)

  List all Message Batches within a Workspace. Most recently created batches are returned first.

• delete

   CompletableFuture<DeletedMessageBatch> delete(MessageBatchDeleteParams params, RequestOptions requestOptions)

  Delete a Message Batch.

  Message Batches can only be deleted once they've finished processing. If you'd like to delete an in-progress batch, you must first cancel it.

• cancel

   CompletableFuture<MessageBatch> cancel(MessageBatchCancelParams params, RequestOptions requestOptions)

  Batches may be canceled any time before processing ends. Once cancellation is initiated, the batch enters a canceling state, at which time the system may complete any in-progress, non-interruptible requests before finalizing cancellation.

  The number of canceled requests is specified in request_counts. To determine which requests were canceled, check the individual results within the batch. Note that cancellation may not result in any canceled requests if they were non-interruptible.

• resultsStreaming

   AsyncStreamResponse<MessageBatchIndividualResponse> resultsStreaming(MessageBatchResultsParams params, RequestOptions requestOptions)

  Streams the results of a Message Batch as a .jsonl file.

  Each line in the file is a JSON object containing the result of a single request in the Message Batch. Results are not guaranteed to be in the same order as requests. Use the custom_id field to match results to requests.