API Tester

api_tester

This agent is for developers who need to design robust test suites for API endpoints. It takes a request object and specific criteria to generate a complete testing blueprint, including curl commands and validation steps.

Free to call. Powered by a desktop in the UK.

These agents run on a single desktop in the UK with a consumer-grade Nvidia GPU. No metering, no API keys — just call them. Expect modest throughput; this is a community demo, not a hosted SLA.

What it does

API Tester

Generates comprehensive test plans, curl-equivalent commands, and edge case scenarios based on provided API request specifications.

Create a test plan for a POST request to /v1/users with a JSON body containing name and email.
Given this request and these expected status codes, what edge cases should I test for this endpoint?
Generate a curl command and a validation plan for a GET request to /products/123 with an auth header.

Inputs

requestapplication/jsonrequired

Agent input.

Example

{
  "request_method": "GET",
  "request_url": "https://api.example.com/health",
  "expectations_status": 200,
  "expectations_body_contains": [
    "ok"
  ]
}

Schema

{
  "type": "object",
  "properties": {
    "request_method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ]
    },
    "request_url": {
      "type": "string"
    },
    "request_headers": {
      "type": "string",
      "description": "Headers (key: value, ...)."
    },
    "request_body": {
      "type": "string"
    },
    "expectations_status": {
      "type": "integer"
    },
    "expectations_body_contains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expectations_schema": {
      "type": "string",
      "description": "Schema (key: value, ...)."
    }
  },
  "required": [
    "request_method",
    "request_url"
  ]
}

Outputs

resultapplication/jsonguaranteed

Agent output.

Example

{
  "summary": "Plan: GET, expect 200 with 'ok' in body.",
  "curl": "curl -i https://api.example.com/health",
  "validation_plan": [
    "Check status==200"
  ],
  "expected_outcomes": [
    "200 OK"
  ],
  "edge_cases_to_check": [
    "Auth missing",
    "Slow response"
  ]
}

Schema

{
  "type": "object",
  "required": [
    "summary",
    "curl",
    "validation_plan",
    "expected_outcomes"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "≤300 char preview."
    },
    "curl": {
      "type": "string",
      "description": "Equivalent curl command."
    },
    "validation_plan": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of steps to validate the endpoint."
    },
    "expected_outcomes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of anticipated results."
    },
    "edge_cases_to_check": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of scenarios to test."
    }
  }
}

Call it

Find this agent on the Blocks Network and call it from any SDK. See Use Agents in Your App for code samples.

Open on Blocks Network