curl --request POST \
  --url https://api.gigstack.io/v2/auth/sandbox \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "email": "persona@empresa.mx",
  "name": "Persona Ejemplo",
  "agent": {
    "client": "claude-code"
  }
}
'

const options = {
  method: 'POST',
  headers: {'Idempotency-Key': '<idempotency-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: 'persona@empresa.mx',
    name: 'Persona Ejemplo',
    agent: {client: 'claude-code'}
  })
};

fetch('https://api.gigstack.io/v2/auth/sandbox', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.gigstack.io/v2/auth/sandbox"

payload = {
    "email": "persona@empresa.mx",
    "name": "Persona Ejemplo",
    "agent": { "client": "claude-code" }
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "team_id": "team_a1b2c3d4e5f6",
    "billing_account_id": "ba_a1b2c3d4e5f6g7h",
    "livemode": false,
    "api_key": {
      "test": null
    },
    "credential_delivery": "not_replayed",
    "claim": {
      "sent_to": "persona@empresa.mx",
      "expires_at": 1767830400000
    }
  },
  "message": "Sandbox already created; the test key is not returned again",
  "timestamp": 1767225600000
}

{
  "success": true,
  "data": {
    "team_id": "team_a1b2c3d4e5f6",
    "billing_account_id": "ba_a1b2c3d4e5f6g7h",
    "livemode": false,
    "api_key": {
      "test": "eyJhbGciOiJIUzI1NiJ9.example.signature"
    },
    "credential_delivery": "first_response",
    "claim": {
      "sent_to": "persona@empresa.mx",
      "expires_at": 1767830400000,
      "delivery": "sent"
    }
  },
  "message": "Sandbox created; the test key is returned only in this response",
  "timestamp": 1767225600000
}

{
  "success": false,
  "error": {
    "code": "email_not_allowed",
    "message": "Use a permanent email address the person reads; disposable inboxes are not accepted"
  },
  "timestamp": 1767225600000
}

{
  "success": false,
  "error": {
    "code": "not_found",
    "message": "Not found"
  },
  "timestamp": 1767225600000
}

{
  "success": false,
  "error": {
    "code": "sandbox_pending_claim",
    "message": "This email has an unclaimed sandbox; a new claim code was sent to it"
  },
  "data": {
    "team_id": "team_a1b2c3d4e5f6",
    "claim": {
      "sent_to": "persona@empresa.mx",
      "expires_at": 1767830400000,
      "delivery": "sent"
    }
  },
  "timestamp": 1767225600000
}

{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many sandbox requests. Retry in 1800 seconds."
  },
  "timestamp": 1767225600000
}

{
  "success": false,
  "error": {
    "code": "sandbox_state_unavailable",
    "message": "Retry the same request later"
  },
  "timestamp": 1767225600000
}