ExecuteService

All Implemented Interfaces:
```
public interface ExecuteService

                    
```
Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public interface`	`ExecuteService.WithRawResponse`	A view of ExecuteService that provides access to raw HTTP responses for each method.

Field Summary

Fields
Modifier and Type	Field	Description

Constructor Summary

Constructors
Constructor	Description

Enum Constant Summary

Enum Constants
Enum Constant	Description

Method Summary

Modifier and Type	Method	Description
`abstract ExecuteService.WithRawResponse`	`withRawResponse()`	Returns a view of this service that provides access to raw HTTP responses for each method.
`abstract ExecuteService`	`withOptions(Consumer<ClientOptions.Builder> modifier)`	Returns a view of this service with the given option modifications applied.
`ExecuteCreateResponse`	`create(ExecuteCreateParams params)`	Creates an ephemeral agent and immediately executes a run.
`abstract ExecuteCreateResponse`	`create(ExecuteCreateParams params, RequestOptions requestOptions)`

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

- Constructor Detail
- Method Detail
  - withRawResponse
```
 abstract ExecuteService.WithRawResponse withRawResponse()
```
    Returns a view of this service that provides access to raw HTTP responses for each method.
  - withOptions
```
 abstract ExecuteService withOptions(Consumer<ClientOptions.Builder> modifier)
```
    Returns a view of this service with the given option modifications applied.
    The original service is not modified.
  - create
```
 ExecuteCreateResponse create(ExecuteCreateParams params)
```
    Creates an ephemeral agent and immediately executes a run. Returns the run ID for polling status and results. This is the fastest way to run an agent without managing agent lifecycle.
    Ephemeral agent lifecycle: The agent created by this endpoint is automatically soft-deleted and its scoped API key revoked when the run completes (whether it succeeds, fails, or times out). Ephemeral agents do not appear in GET /agent/v1/agents listings. The returned agentId is valid only for the duration of the run — do not store it for reuse. For persistent, reusable agents, use POST /agent/v1/agents instead.
  - create
```
 abstract ExecuteCreateResponse create(ExecuteCreateParams params, RequestOptions requestOptions)
```