Vegeta · JSON Structure

Vegeta Attack Structure

Vegeta attack configuration defining rate, duration, target, and HTTP options for a load test run

Type: object Properties: 12 Required: 2
GoHTTPLoad TestingPerformanceTesting

VegetaAttack is a JSON Structure definition published by Vegeta, describing 12 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

rate duration target timeout workers max-workers connections redirects insecure http2 keepalive chunked

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

vegeta-attack-structure.json Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/vegeta/refs/heads/main/json-structure/vegeta-attack-structure.json",
  "name": "VegetaAttack",
  "description": "Vegeta attack configuration defining rate, duration, target, and HTTP options for a load test run",
  "type": "object",
  "properties": {
    "rate": {
      "type": "int32",
      "description": "Request rate in requests per second (0 for maximum rate)",
      "minimum": 0,
      "example": 100
    },
    "duration": {
      "type": "string",
      "description": "Attack duration as a Go duration string (e.g. 30s, 1m, 5m30s)",
      "example": "30s"
    },
    "target": {
      "type": "object",
      "description": "HTTP target specification for the attack",
      "properties": {
        "method": {
          "type": "string",
          "description": "HTTP method",
          "enum": [
            "GET",
            "POST",
            "PUT",
            "DELETE",
            "PATCH",
            "HEAD",
            "OPTIONS"
          ],
          "example": "GET"
        },
        "url": {
          "type": "uri",
          "description": "Target URL",
          "example": "https://api.example.com/v1/users"
        },
        "header": {
          "type": "object",
          "description": "HTTP headers as key-value pairs",
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "example": {
            "Authorization": [
              "Bearer token123"
            ],
            "Content-Type": [
              "application/json"
            ]
          }
        },
        "body": {
          "type": "string",
          "description": "Base64-encoded request body",
          "example": "eyJrZXkiOiAidmFsdWUifQ=="
        }
      },
      "required": [
        "method",
        "url"
      ]
    },
    "timeout": {
      "type": "string",
      "description": "Request timeout as a Go duration string",
      "example": "30s"
    },
    "workers": {
      "type": "int32",
      "description": "Number of initial workers (goroutines) sending requests",
      "minimum": 1,
      "example": 10
    },
    "max-workers": {
      "type": "int32",
      "description": "Maximum number of workers (goroutines) sending requests",
      "minimum": 1,
      "example": 18446744073709551615
    },
    "connections": {
      "type": "int32",
      "description": "Maximum number of idle open connections per target host",
      "minimum": 0,
      "example": 10000
    },
    "redirects": {
      "type": "int32",
      "description": "Number of redirects to follow (-1 to not follow)",
      "example": 10
    },
    "insecure": {
      "type": "boolean",
      "description": "Disable TLS certificate verification",
      "example": false
    },
    "http2": {
      "type": "boolean",
      "description": "Enable HTTP/2 request sending",
      "example": true
    },
    "keepalive": {
      "type": "boolean",
      "description": "Enable persistent connections (keep-alive)",
      "example": true
    },
    "chunked": {
      "type": "boolean",
      "description": "Enable chunked transfer encoding for request bodies",
      "example": false
    }
  },
  "required": [
    "rate",
    "duration"
  ]
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/vegeta-attack-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.