Agent guide

OpenAPI Launch Pack API for AI agents

Use a public, sanitized OpenAPI document to produce launch assets: marketplace copy, endpoint summaries, curl examples, a Postman collection, and normalized OpenAPI output. This agent guide explains when to call OpenAPI Launch Pack API, when not to call it, which outputs to inspect, and how to route human users to RapidAPI or product docs.

When an agent should call this API

  • You are preparing a RapidAPI listing or refreshing an existing one.
  • You have a public or sanitized OpenAPI spec and want to avoid exposing private, admin, or health-only routes.
  • You need endpoint summaries, curl examples, and a Postman collection from one source.
  • You want platform-specific readiness notes for RapidAPI, Postman, SDK generation, and a docs site.
  • You want launch copy that follows the API contract instead of a separate marketing document.

Do not call it for

  • Not full API governance, design linting, or versioning policy.
  • Not a replacement for human positioning, pricing, or support copy.
  • Not a marketplace publisher that deploys listings for you.

First call for agents

Use the smallest request, then inspect named outputs.

curl -X POST 'https://openapi-launch-pack-api.linkridge.net/v1/openapi/analyze' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: <your-api-key>' \
  -d '{
  "target_server_url": "https://demo-api.example.com",
  "spec": {
    "openapi": "3.0.3",
    "info": {
      "title": "Demo API",
      "version": "1.0.0",
      "description": "A small API used to demonstrate launch-pack generation."
    },
    "paths": {
      "/health": {
        "get": {
          "summary": "Health check",
          "operationId": "health",
          "responses": {
            "200": {
              "description": "OK"
            }
          }
        }
      }
    }
  }
}'

Prefer marketplace auth? Open in RapidAPI for plans, keys, and interactive testing.

Response fields to inspect

{
  "valid": true,
  "title": "Demo API",
  "summary": {
    "operation_count": 1,
    "path_count": 1,
    "has_security": false
  },
  "issues": [],
  "rapidapi": {
    "name": "Demo API",
    "short_description": "A small API used to demonstrate launch-pack generation.",
    "support_email": "api-support@makersridge.com"
  },
  "endpoint_summaries": [
    {
      "method": "GET",
      "path": "/health",
      "summary": "Health check",
      "operationId": "health"
    }
  ],
  "curl_examples": [
    {
      "name": "GET /health",
      "command": "curl --request GET 'https://demo-api.example.com/health'"
    }
  ],
  "postman_collection": {
    "info": {
      "name": "Demo API"
    },
    "item": [
      {
        "name": "Health check",
        "request": {
          "method": "GET",
          "url": "https://demo-api.example.com/health"
        }
      }
    ]
  },
  "platform_launch_packs": {
    "rapidapi": {
      "label": "RapidAPI launch pack",
      "readiness_score": 100,
      "remediation_steps": []
    },
    "postman": {
      "item_count": 1,
      "remediation_steps": []
    },
    "sdk_readiness": {
      "generator_notes": [
        "operationId values are present; keep them stable before SDK generation."
      ]
    },
    "docs_site": {
      "page_outline": [
        {
          "section": "Hero",
          "purpose": "Explain the API and the first useful call."
        },
        {
          "section": "First call",
          "purpose": "Show GET /health as the smallest smoke path."
        }
      ]
    }
  },
  "normalized_openapi": {
    "servers": [
      {
        "url": "https://demo-api.example.com"
      }
    ]
  }
}