Optimize & Predict

Submit an infrastructure optimization job

Analyzes your current architecture and generates 50+ tested variations with ranked recommendations for cost/performance optimization.

Ownership requirement: The simulationId must refer to a simulation that was created with, or claimed by, the same API key used in this request. Simulations created via the public browser workspace (i.e. POST /api/simulations without an Authorization header) are unowned and will return 403 here until claimed. To associate ownership, either:

  • Create the simulation with a Bearer token from the start: POST /api/simulations with Authorization: Bearer <key>, or
  • Claim an existing unowned simulation before calling this endpoint: POST /api/simulations/{simulationId}/claim.
post/analysis/optimize

Request

  • Base URL: https://www.cloudworldmodel.ai/api
  • URL: https://www.cloudworldmodel.ai/api/analysis/optimize
  • Auth: one of:
    • HTTP bearer
    • API key in header X-PAYMENT
    • API key in header PAYMENT-SIGNATURE

Request body

simulationIdstring required

ID of simulation to optimize

webhookUrlstring uri

Optional HTTPS URL to receive webhook notification when job completes

webhookSecretstring

Optional secret for HMAC-SHA256 webhook signature verification

Example request

{
  "simulationId": "sim-abc123",
  "goals": {
    "primary": "minimize_cost",
    "constraints": {
      "max_cost_per_hour": 10,
      "min_throughput": 5000,
      "max_latency_p95": 200
    }
  }
}

Response

Optimization job accepted

messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.