class

Anthropic::Beta

Inherits Reference < Object

Beta namespace for accessing beta features

Mirrors Ruby SDK pattern:

client.beta.messages.create(
  betas: ["structured-outputs-2025-12-15"],
  ...
)

Constructors

new(client : Client)
Source

Instance methods

agents

Access beta agents API

Source
deployment_runs

Access beta deployment runs API

Source
deployments

Access beta deployments API

deployment = client.beta.deployments.create(
  agent: "agent_123",
  environment_id: "env_123",
  name: "Nightly summary",
  initial_events: [{"type" => "user.message", "content" => [{"type" => "text", "text" => "Summarize the day."}]}]
)
client.beta.deployments.run(deployment.id)
Source
dreams

Access beta Dreams API (memory consolidation, research preview).

Auto-merges managed-agents-2026-04-01 and dreaming-2026-04-21. Research-preview access must be requested; without it the API returns 404.

dream = client.beta.dreams.create(
  inputs: [
    Anthropic::BetaDreamMemoryStoreInput.new("memstore_abc"),
    Anthropic::BetaDreamSessionsInput.new(["sess_1"]),
  ],
  model: "claude-opus-4-7",
)
client.beta.dreams.retrieve(dream.id)
Source
environments

Access beta environments API

Source
files

Access beta files API

file = client.beta.files.upload(Path["document.pdf"])
client.beta.files.delete(file.id)
Source
memory_stores

Access beta memory stores API

Source
messages

Access beta messages API

Source
models

Access beta models API

Source
organization

Access the beta Organization Admin API.

org = client.beta.organization.retrieve
users = client.beta.organization.users.list
Source
sessions

Access beta sessions API

Source
skills

Access beta skills API

skills = client.beta.skills.list
skill = client.beta.skills.retrieve("skill_abc123")
Source
tunnels

Access beta MCP Tunnels API (research preview).

Auto-merges mcp-tunnels-2026-06-22. Tunnel management requires a Workload Identity Federation bearer with workspace:manage_tunnels (standard API keys return 401). Using a tunnel URL from Messages is separate and uses a normal API key + MCP client beta.

tunnel = client.beta.tunnels.create(display_name: "prod-gateway")
token = client.beta.tunnels.reveal_token(tunnel.id)
cert = client.beta.tunnels.certificates.create(
  tunnel.id,
  ca_certificate_pem: File.read("ca.pem"),
)
Source
user_profiles

Access beta user profiles API

profile = client.beta.user_profiles.create(external_id: "user-123")
url = client.beta.user_profiles.create_enrollment_url(profile.id)
Source
vaults

Access beta vaults API

Source
webhooks

Access beta webhooks verification utility

Source