REST Client · JSON Structure

Rest Client Request Structure

Structure of an HTTP request authored in a .http or .rest file for the VS Code REST Client extension.

Type: Properties: 0
ClientsHTTP ClientIDE ExtensionVS CodeAPI Testing

REST Client HTTP Request is a JSON Structure definition published by REST Client.

Meta-schema:

JSON Structure

rest-client-request-structure.json Raw ↑
{
  "name": "REST Client HTTP Request",
  "description": "Structure of an HTTP request authored in a .http or .rest file for the VS Code REST Client extension.",
  "fields": [
    {
      "name": "method",
      "type": "string",
      "required": true,
      "description": "HTTP method: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS."
    },
    {
      "name": "url",
      "type": "string",
      "required": true,
      "description": "Request URL, may include {{variable}} placeholders."
    },
    {
      "name": "httpVersion",
      "type": "string",
      "required": false,
      "description": "HTTP version: HTTP/1.1 or HTTP/2."
    },
    {
      "name": "headers",
      "type": "object",
      "required": false,
      "description": "Request headers as key: value pairs, one per line."
    },
    {
      "name": "body",
      "type": "any",
      "required": false,
      "description": "Request body following a blank line after headers."
    },
    {
      "name": "name",
      "type": "string",
      "required": false,
      "description": "Named request for variable extraction, set with # @name myRequest."
    },
    {
      "name": "variables",
      "type": "object",
      "required": false,
      "description": "File-level variables defined with @variableName = value.",
      "fields": [
        {
          "name": "key",
          "type": "string",
          "description": "Variable name (without @ prefix)."
        },
        {
          "name": "value",
          "type": "string",
          "description": "Variable value or system variable reference."
        }
      ]
    },
    {
      "name": "systemVariables",
      "type": "array",
      "required": false,
      "description": "Built-in dynamic variables.",
      "items": [
        { "name": "$guid", "description": "Generates a new UUID v4." },
        { "name": "$timestamp", "description": "Current Unix timestamp." },
        { "name": "$datetime", "description": "Current date/time in ISO 8601." },
        { "name": "$randomInt", "description": "Random integer 0–1000." },
        { "name": "$processEnv", "description": "Value from OS environment variable." },
        { "name": "$dotenv", "description": "Value from .env file variable." }
      ]
    },
    {
      "name": "graphql",
      "type": "object",
      "required": false,
      "description": "GraphQL request body.",
      "fields": [
        {
          "name": "query",
          "type": "string",
          "required": true,
          "description": "GraphQL query or mutation string."
        },
        {
          "name": "variables",
          "type": "object",
          "required": false,
          "description": "GraphQL query variable values."
        }
      ]
    }
  ]
}

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/rest-client-request-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.