Agent signup

# 1. Sign up (no API key needed)
curl -X POST "https://inkbox.ai/api/v1/agent-signup/" \
  -H "Content-Type: application/json" \
  -d '{
      "human_email": "john@example.com",
      "display_name": "Research Assistant",
      "note_to_human": "Hi John, I am your research assistant. Please verify me!",
      "harness": "claude-code"
  }'
# Response includes api_key and email_address. Store the key securely.

# 2. Send an email to the human (allowed before verification)
curl -X POST "https://inkbox.ai/api/v1/mail/mailboxes/research-assistant-a1b2c3@inkboxmail.com/messages" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "recipients": {"to": ["john@example.com"]},
      "subject": "Hello from your research assistant",
      "body_text": "I just signed up for Inkbox. Check your email for the verification code!"
  }'

# 3. Check inbox
curl -X GET "https://inkbox.ai/api/v1/mail/mailboxes/research-assistant-a1b2c3@inkboxmail.com/messages" \
  -H "X-API-Key: YOUR_API_KEY"

# 4. Verify with the 6-digit code the human received
curl -X POST "https://inkbox.ai/api/v1/agent-signup/verify" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"verification_code": "483921"}'

# 5. Now the agent can send to anyone
curl -X POST "https://inkbox.ai/api/v1/mail/mailboxes/research-assistant-a1b2c3@inkboxmail.com/messages" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "recipients": {"to": ["colleague@example.com"]},
      "subject": "Research findings",
      "body_text": "Here are the results of my analysis..."
  }'

from inkbox import Inkbox

# 1. Sign up (no API key needed)
result = Inkbox.signup(
    human_email="john@example.com",
    display_name="Research Assistant",
    note_to_human="Hi John, I'm your research assistant. Please verify me!",
    harness="claude-code",
)
api_key = result.api_key        # store securely, shown only once
email = result.email_address    # e.g. research-assistant-a1b2c3@inkboxmail.com

# 2. Send an email to the human (allowed before verification)
with Inkbox(api_key=api_key) as inkbox:
    inkbox.messages.send(
        email,
        to=["john@example.com"],
        subject="Hello from your research assistant",
        body_text="I just signed up for Inkbox. Check your email for the verification code!",
    )

    # 3. Check inbox
    messages = inkbox.messages.list(email)

# 4. Verify with the 6-digit code the human received
Inkbox.verify_signup(api_key, verification_code="483921")

# 5. Now the agent can send to anyone
with Inkbox(api_key=api_key) as inkbox:
    inkbox.messages.send(
        email,
        to=["colleague@example.com"],
        subject="Research findings",
        body_text="Here are the results of my analysis...",
    )

import { Inkbox } from "@inkbox/sdk";

// 1. Sign up (no API key needed)
const result = await Inkbox.signup({
  humanEmail: "john@example.com",
  displayName: "Research Assistant",
  noteToHuman: "Hi John, I'm your research assistant. Please verify me!",
  harness: "claude-code",
});
const apiKey = result.apiKey;        // store securely, shown only once
const email = result.emailAddress;   // e.g. research-assistant-a1b2c3@inkboxmail.com

// 2. Send an email to the human (allowed before verification)
const inkbox = new Inkbox({ apiKey });
await inkbox.messages.send(email, {
  to: ["john@example.com"],
  subject: "Hello from your research assistant",
  bodyText: "I just signed up for Inkbox. Check your email for the verification code!",
});

// 3. Check inbox
const messages = await inkbox.messages.list(email);

// 4. Verify with the 6-digit code the human received
await Inkbox.verifySignup(apiKey, { verificationCode: "483921" });

// 5. Now the agent can send to anyone
await inkbox.messages.send(email, {
  to: ["colleague@example.com"],
  subject: "Research findings",
  bodyText: "Here are the results of my analysis...",
});

# 1. Sign up (no API key needed)
inkbox signup create \
  --human-email john@example.com \
  --display-name "Research Assistant" \
  --note-to-human "Hi John, I am your research assistant. Please verify me!" \
  --harness claude-code
# If you received an A2A invitation, add --invitation-prompt.
# Automation can use INKBOX_A2A_INVITATION or --invitation-stdin.
# Never place an invitation link or token directly in a command-line argument.
# Replace these values with the returned api_key and agent_handle.
export INKBOX_API_KEY="YOUR_RETURNED_API_KEY"
export INKBOX_AGENT_HANDLE="research-assistant-a1b2c3"

# 2. Send an email to the human (allowed before verification)
inkbox email send \
  -i "$INKBOX_AGENT_HANDLE" \
  --to john@example.com \
  --subject "Hello from your research assistant" \
  --body-text "I just signed up for Inkbox. Check your email for the verification code!"

# 3. Check inbox
inkbox email list -i "$INKBOX_AGENT_HANDLE"

# 4. Verify with the 6-digit code the human received
inkbox signup verify --code 483921

# 5. Now the agent can send to anyone
inkbox email send \
  -i "$INKBOX_AGENT_HANDLE" \
  --to colleague@example.com \
  --subject "Research findings" \
  --body-text "Here are the results of my analysis..."

status = Inkbox.get_signup_status(api_key)
print(status.claim_status)                    # "agent_unclaimed" or "agent_claimed"
print(status.restrictions.max_sends_per_day)  # Effective 24-hour recipient-send limit

const status = await Inkbox.getSignupStatus(apiKey);
console.log(status.claimStatus);                // "agent_unclaimed" or "agent_claimed"
console.log(status.restrictions.maxSendsPerDay); // Effective 24-hour recipient-send limit

curl -X GET "https://inkbox.ai/api/v1/agent-signup/status" \
  -H "X-API-Key: YOUR_API_KEY"

inkbox signup status