class

Anthropic::BetaSessions

Inherits Reference < Object

Sessions API resource (beta)

Constructors

new(client : Client)
Source

Instance methods

archive(session_id : String, betas : Array(String) = [] of String) : BetaManagedAgentsSession

Archive a session

Source
create(environment_id : String, agent : BetaManagedAgentsAgentParamLike, title : String | Nil = nil, metadata : Hash(String, String) | Nil = nil, resources : Enumerable(BetaManagedAgentsSessionResourceParam) | Nil = nil, vault_ids : Array(String) | Nil = nil, initial_events : Array(JSON::Any | Hash(String, JSON::Any)) | Nil = nil, betas : Array(String) = [] of String) : BetaManagedAgentsSession

Create a session.

initial_events sends events to the session at creation (processed in order). Supports user.message and user.define_outcome events. Maximum 50 events per the API.

client.beta.sessions.create(
  environment_id: env.id,
  agent: agent.id,
  initial_events: [
    {"type" => "user.message", "content" => [{"type" => "text", "text" => "Hello"}]},
  ],
)
Source
delete(session_id : String, betas : Array(String) = [] of String) : BetaManagedAgentsDeletedSession

Delete a session

Source
events
Source
list(include_archived : Bool | Nil = nil, limit : Int32 = 20, page : String | Nil = nil, betas : Array(String) = [] of String) : BetaSessionListResponse

List sessions

Source
resources
Source
retrieve(session_id : String, betas : Array(String) = [] of String) : BetaManagedAgentsSession

Retrieve a session

Source
threads
Source
update(session_id : String, agent : BetaManagedAgentsAgentParamLike | Nil = nil, title : String | Nil = nil, metadata : Hash(String, String) | Nil = nil, betas : Array(String) = [] of String) : BetaManagedAgentsSession

Update a session

Source