{
  "api_spec_url": "https://userbob.com/openapi.json",
  "auth": {
    "instructions": "Please login to your UserBob account and retrieve your API key from https://userbob.com/enterprise#apiKey. Every request also requires your numeric clientId as a query parameter (clientId=0 is invalid).",
    "parameter_name": "apiKey",
    "type": "api_key"
  },
  "capabilities": {
    "demographic_options": [
      "Male",
      "Female",
      "Single",
      "Married",
      "Under30",
      "Over30",
      "CollegeGrad",
      "NotCollegeGrad",
      "Pets",
      "NoPets",
      "Urban",
      "NotUrban",
      "Kids",
      "NoKids",
      "Android",
      "iOS",
      "<30k",
      ">30k",
      "<50k",
      ">50k",
      "<75k",
      ">75k"
    ],
    "test_constraints": {
      "max_duration_minutes": 20,
      "max_users": 9,
      "min_duration_minutes": 1,
      "min_users": 1,
      "polling_interval_seconds": 600
    }
  },
  "categories": [
    "ux research",
    "user feedback"
  ],
  "contact_email": "support@userbob.com",
  "description": "An AI agent capable of creating, managing, and analyzing remote user usability tests via UserBob.com.",
  "flows": [{
    "description": "The sequence required to safely create and start a test with sufficient funds.",
    "id": "start_usability_test",
    "steps": [
      {
        "action": "apiCreateTest",
        "note": "Requires clientId and apiKey. instructions is required unless numMinutes is 1, in which case the first-impression prompt is used. Demographics is optional. Returns the exact 'cost' of the requested test; use that value rather than the pricing_logic estimate.",
        "url": "https://userbob.com/apiCreateTest"
      },
      {
        "action": "apiGetBalance",
        "note": "Compare 'balance' with the 'cost' from the previous step.",
        "url": "https://userbob.com/apiGetBalance"
      },
      {
        "action": "apiStartTest",
        "condition": "Proceed only if balance >= cost",
        "url": "https://userbob.com/apiStartTest"
      }
    ]
  }],
  "homepage": "https://userbob.com",
  "name": "User Experience Researcher",
  "pricing_logic": {
    "app_test": "numUsers * (numMinutes * 1.50 + 2.00)",
    "mobile_web_test": "numUsers * (numMinutes * 1.50 + 1.00)",
    "note": "USD. Exact cost is returned by apiCreateTest.",
    "web_test": "numUsers * numMinutes * 1.50"
  },
  "version": "1.0.0"
}