Help

Schedule a suite

Put a saved suite that targets the sandbox agent on a weekly schedule, and it runs each week without you.

Steps

  1. Confirm your email first. Schedules wait for it.
  2. In Studio, open Tests. Find the suite your first demo run saved; it targets the sandbox agent. Set its Schedule to Weekly.
  3. Or create a scheduled suite with POST /api/tests/suites. Give it a name, the sandbox target and your scenarios. Each scenario keeps its own goal, persona and expected lines.
    curl -s -X POST https://api.wordis-bond.com/api/tests/suites \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Weekly booking check",
        "schedule": "weekly",
        "targetAgent": { "transport": "direct", "peerId": "wb-demo-dental" },
        "scenarios": [
          { "goal": "Book a teeth cleaning and ask what it costs",
            "persona": { "name": "Alex", "description": "a new patient booking a routine cleaning" } }
        ]
      }'
  4. The first run starts at the next hourly check after you save. After that the suite runs once each week; weeks start Monday 00:00 UTC. Every scenario in the suite runs.
  5. Find the scheduled runs under Tests with your other runs. Each one has its own scorecard.
  6. To stop it, set Schedule to Manual on the suite's row, or press Delete. Past runs are kept.

What you get

One scored run per scenario each week, with no one pressing run.

If something fails

StatusCodeMessageWhat it means
403EMAIL_VERIFICATION_REQUIREDVerify your email before creating scheduled suites.Confirm your email, then save the suite with a schedule.
403EMAIL_VERIFICATION_REQUIREDVerify your email before scheduling suites.You set a schedule on an existing suite before confirming your email.
422VALIDATION_ERRORname is requiredGive the suite a name.
422VALIDATION_ERRORtargetAgent.transport is requiredAdd the target, for example the sandbox target above.
404SUITE_NOT_FOUNDSuite not foundYou changed or deleted a suite id this account does not have.

Not ready yet

  • Schedules run only against the sandbox agent today. A suite aimed at your own voice agent is not run on a schedule yet.
  • On the free tier, choose Weekly. Daily and hourly schedules have not yet been checked on production.

Last checked 2026-10-11. More help: Sign up and run your first test · Read a scorecard · Run a suite from CI · Score a captured transcript.