Blue Guardrails

Create Optimization Run

Validate immutable inputs and create a pending optimization run.

POST
/v1/optimization-runs

Header Parameters

x-workspace-id?|

Workspace UUID for session-authenticated calls.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://loading/v1/optimization-runs" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "goal": "string",    "inputs": {},    "config": {      "agent_model": "string"    }  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "capability_keys": [
    "string"
  ],
  "goal": "string",
  "status": "preparing",
  "config": {
    "agent_model": "string",
    "evaluator_id": "92c2c259-25b9-47e2-bc3b-bd161a87f750",
    "models_in_scope": [
      "string"
    ],
    "max_experiments": 1
  },
  "usage": {
    "agent_turns": 0,
    "agent_input_tokens": 0,
    "agent_cached_input_tokens": 0,
    "agent_output_tokens": 0,
    "agent_reasoning_tokens": 0,
    "experiments_created": 0
  },
  "created_by_user_id": "209f54c4-4c33-43bc-9c6a-ef4c65ad7473",
  "created_by_user_name": "string",
  "created_by_service_account_id": "5434fcf1-291e-49ce-ac43-2f469070b2f5",
  "created_by_service_account_name": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z",
  "inputs": {
    "conversation_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "experiment_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "context": "string",
    "files": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "filename": "string",
        "media_type": "string",
        "size_bytes": 0,
        "sha256": "string"
      }
    ]
  },
  "capabilities": [
    {
      "key": "string",
      "kind": "tool",
      "name": "string",
      "description": "string",
      "tools": [
        "string"
      ],
      "policy_grants": [
        "string"
      ],
      "config": {
        "evaluator_id": "92c2c259-25b9-47e2-bc3b-bd161a87f750",
        "models_in_scope": [
          "string"
        ],
        "max_experiments": 0
      },
      "skills": [
        {
          "source_skill_id": "a6c19203-f435-41a5-b152-83f1b43fab0f",
          "name": "string",
          "description": "string",
          "package_sha256": "string",
          "size_bytes": 0
        }
      ]
    }
  ],
  "created_experiments": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "model": "string",
      "completed_at": "2019-08-24T14:15:22Z"
    }
  ],
  "report": {
    "format": "markdown",
    "content": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "assets": [
      {
        "type": "vega-lite",
        "file_name": "string",
        "content": "string",
        "sha256": "string",
        "size_bytes": 0
      }
    ]
  },
  "suggested_prompts": [
    {
      "file_name": "string",
      "content": "string"
    }
  ],
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}