Skip to main content

Documentation

Shroud gives AI agents disposable identity primitives: virtual cards, burner phones, and temporary email inboxes, all behind one API.

Public Beta

Shroud is in public beta. Start with a small workflow, validate your webhook handling, then scale up as your agent runtime stabilizes.

Quick Start​

Get up and running in minutes. Install the SDK, create a profile, let your agent use it, then destroy it when the task is done.

1. Install the SDK​

# Python
pip install shroud-sdk

# TypeScript
npm install @shroud/sdk

2. Initialize the client​

from shroud import Shroud

client = Shroud(api_key="shr_sk_your_key_here")

3. Create a session profile​

A SessionProfile bundles a virtual card, burner phone, and disposable email into one coherent identity for a single agent task.

profile = client.profiles.create(
    budget=50.00,
    capabilities=["card", "phone", "email"]
)

print(profile.card.number)   # 4242 **** **** 1234
print(profile.phone.digits)  # +1 (415) 555-0192
print(profile.email.address) # agent_8x2k@proxy.shroud.dev

4. Use the credentials​

Your agent signs up for services with these credentials. When the service sends an OTP or verification link, Shroud intercepts it and forwards structured data to your backend via webhook.

otp = client.webhooks.wait_for_sms(profile.phone.id, timeout=30)
print(f"Received OTP: {otp.code}")  # 849102

5. Destroy the profile​

When the workflow is done, tear everything down with one call.

profile.destroy()
# Card closed, phone recycled, email alias deleted.
# Zero trace left behind.

What you should understand next​

  • SessionProfile: the top-level identity container for one task.
  • Ephemeral Credentials: temporary, budget-capped resources that auto-expire.
  • Webhook Flow: how OTPs and verification links are captured and delivered.
  • Cryptographic Shredding: how teardown makes sensitive data irrecoverable.

Continue with the Core Concepts guide, review the System Design, then move into the API Reference or SDKs.