in anthropic-java-core/src/main/kotlin/com/anthropic/services/blocking/messages/BatchService.kt [71:247]
fun list(
params: BatchListParams = BatchListParams.none(),
requestOptions: RequestOptions = RequestOptions.none(),
): BatchListPage
/** @see [list] */
fun list(params: BatchListParams = BatchListParams.none()): BatchListPage =
list(params, RequestOptions.none())
/** @see [list] */
fun list(requestOptions: RequestOptions): BatchListPage =
list(BatchListParams.none(), 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.
*
* Learn more about the Message Batches API in our
* [user guide](/en/docs/build-with-claude/batch-processing)
*/
fun delete(params: BatchDeleteParams): DeletedMessageBatch =
delete(params, RequestOptions.none())
/** @see [delete] */
fun delete(
params: BatchDeleteParams,
requestOptions: RequestOptions = RequestOptions.none(),
): DeletedMessageBatch
/**
* 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.
*
* Learn more about the Message Batches API in our
* [user guide](/en/docs/build-with-claude/batch-processing)
*/
fun cancel(params: BatchCancelParams): MessageBatch = cancel(params, RequestOptions.none())
/** @see [cancel] */
fun cancel(
params: BatchCancelParams,
requestOptions: RequestOptions = RequestOptions.none(),
): MessageBatch
/**
* 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.
*
* Learn more about the Message Batches API in our
* [user guide](/en/docs/build-with-claude/batch-processing)
*/
@MustBeClosed
fun resultsStreaming(
params: BatchResultsParams
): StreamResponse<MessageBatchIndividualResponse> =
resultsStreaming(params, RequestOptions.none())
/** @see [resultsStreaming] */
@MustBeClosed
fun resultsStreaming(
params: BatchResultsParams,
requestOptions: RequestOptions = RequestOptions.none(),
): StreamResponse<MessageBatchIndividualResponse>
/** A view of [BatchService] that provides access to raw HTTP responses for each method. */
interface WithRawResponse {
/**
* Returns a raw HTTP response for `post /v1/messages/batches`, but is otherwise the same as
* [BatchService.create].
*/
@MustBeClosed
fun create(params: BatchCreateParams): HttpResponseFor<MessageBatch> =
create(params, RequestOptions.none())
/** @see [create] */
@MustBeClosed
fun create(
params: BatchCreateParams,
requestOptions: RequestOptions = RequestOptions.none(),
): HttpResponseFor<MessageBatch>
/**
* Returns a raw HTTP response for `get /v1/messages/batches/{message_batch_id}`, but is
* otherwise the same as [BatchService.retrieve].
*/
@MustBeClosed
fun retrieve(params: BatchRetrieveParams): HttpResponseFor<MessageBatch> =
retrieve(params, RequestOptions.none())
/** @see [retrieve] */
@MustBeClosed
fun retrieve(
params: BatchRetrieveParams,
requestOptions: RequestOptions = RequestOptions.none(),
): HttpResponseFor<MessageBatch>
/**
* Returns a raw HTTP response for `get /v1/messages/batches`, but is otherwise the same as
* [BatchService.list].
*/
@MustBeClosed fun list(): HttpResponseFor<BatchListPage> = list(BatchListParams.none())
/** @see [list] */
@MustBeClosed
fun list(
params: BatchListParams = BatchListParams.none(),
requestOptions: RequestOptions = RequestOptions.none(),
): HttpResponseFor<BatchListPage>
/** @see [list] */
@MustBeClosed
fun list(params: BatchListParams = BatchListParams.none()): HttpResponseFor<BatchListPage> =
list(params, RequestOptions.none())
/** @see [list] */
@MustBeClosed
fun list(requestOptions: RequestOptions): HttpResponseFor<BatchListPage> =
list(BatchListParams.none(), requestOptions)
/**
* Returns a raw HTTP response for `delete /v1/messages/batches/{message_batch_id}`, but is
* otherwise the same as [BatchService.delete].
*/
@MustBeClosed
fun delete(params: BatchDeleteParams): HttpResponseFor<DeletedMessageBatch> =
delete(params, RequestOptions.none())
/** @see [delete] */
@MustBeClosed
fun delete(
params: BatchDeleteParams,
requestOptions: RequestOptions = RequestOptions.none(),
): HttpResponseFor<DeletedMessageBatch>
/**
* Returns a raw HTTP response for `post /v1/messages/batches/{message_batch_id}/cancel`,
* but is otherwise the same as [BatchService.cancel].
*/
@MustBeClosed
fun cancel(params: BatchCancelParams): HttpResponseFor<MessageBatch> =
cancel(params, RequestOptions.none())
/** @see [cancel] */
@MustBeClosed
fun cancel(
params: BatchCancelParams,
requestOptions: RequestOptions = RequestOptions.none(),
): HttpResponseFor<MessageBatch>
/**
* Returns a raw HTTP response for `get /v1/messages/batches/{message_batch_id}/results`,
* but is otherwise the same as [BatchService.resultsStreaming].
*/
@MustBeClosed
fun resultsStreaming(
params: BatchResultsParams
): HttpResponseFor<StreamResponse<MessageBatchIndividualResponse>> =
resultsStreaming(params, RequestOptions.none())
/** @see [resultsStreaming] */
@MustBeClosed
fun resultsStreaming(
params: BatchResultsParams,
requestOptions: RequestOptions = RequestOptions.none(),
): HttpResponseFor<StreamResponse<MessageBatchIndividualResponse>>
}