---
title: "POST /model-hub/eval-templates/<template_id>/composite/execute/"
method: POST
path: "/model-hub/eval-templates/{template_id}/composite/execute/"
tags: ["model-hub"]
---

# POST /model-hub/eval-templates/<template_id>/composite/execute/

`POST /model-hub/eval-templates/{template_id}/composite/execute/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/model-hub/eval-templates/{template_id}/composite/execute/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Execute all child evals in a composite and optionally aggregate results.
Thin wrapper around `execute_composite_children_sync` — the same helper
the dataset/experiment `CompositeEvaluationRunner` uses, so aggregation
semantics stay consistent across surfaces.

## Request body

- CompositeEvalExecuteRequest
  - `mapping` object, required
  - `model` string, nullable
  - `config` object
  - `error_localizer` boolean
  - `input_data_types` object
  - `span_context` object, nullable
  - `trace_context` object, nullable
  - `session_context` object, nullable
  - `call_context` object, nullable
  - `row_context` object, nullable

## Response `200`

OK

- CompositeEvalExecuteResponse
  - `status` boolean, required
  - `result` CompositeEvalExecuteResponseResult, required
    - `composite_id` string, nullable
    - `composite_name` string, required
    - `aggregation_enabled` boolean, required
    - `aggregation_function` string, nullable
    - `aggregate_score` number, nullable
    - `aggregate_pass` boolean, nullable
    - `children` CompositeChildResult[], required
      - `child_id` string, uuid, required
      - `child_name` string, required
      - `order` integer, required
      - `score` number, nullable
      - `output` object, nullable
      - `reason` string, nullable
      - `output_type` string, nullable
      - `status` string, required
      - `error` string, nullable
      - `log_id` string, nullable
      - `weight` number
      - `error_localizer_result` object, nullable
    - `summary` string, nullable
    - `error_localizer_results` object, nullable
    - `total_children` integer, required
    - `completed_children` integer, required
    - `failed_children` integer, required
    - `evaluation_id` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)