---
title: "PUT /model-hub/ground-truth/{ground_truth_id}/setup/"
method: PUT
path: "/model-hub/ground-truth/{ground_truth_id}/setup/"
tags: ["model-hub"]
---

# PUT /model-hub/ground-truth/{ground_truth_id}/setup/

`PUT /model-hub/ground-truth/{ground_truth_id}/setup/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/model-hub/ground-truth/{ground_truth_id}/setup/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

PUT /model-hub/ground-truth/<id>/setup/

## Request body

- GroundTruthSetupRequest
  - `variable_mapping` object, required: Map of template variable name to GT column name (string) or list of column names. Keys are dynamic per-template.
  - `role_mapping` GroundTruthRoleMapping, nullable, required
    - `output` string
    - `explanation` string
    - `expected_output` string: Legacy alias for `output`.
    - `reasoning` string: Legacy alias for `explanation`.
    - `reason` string: Legacy alias for `explanation`.
  - `max_examples` integer, required
  - `enabled` boolean

## Response `200`

OK

- GroundTruthSetupResponse
  - `status` boolean, required
  - `result` GroundTruthSetupResponseResult, required
    - `id` string, uuid, required
    - `template_id` string, uuid, required
    - `variable_mapping` object, nullable: Map of template variable name to GT column name (string) or list of column names.
    - `role_mapping` GroundTruthRoleMapping, nullable
      - `output` string
      - `explanation` string
      - `expected_output` string: Legacy alias for `output`.
      - `reasoning` string: Legacy alias for `explanation`.
      - `reason` string: Legacy alias for `explanation`.
    - `embedding_status` string, required
    - `embeddings_stale` boolean
    - `config` GroundTruthRuntimeConfig, required
      - `enabled` boolean, required
      - `ground_truth_id` string, uuid, required
      - `max_examples` integer, required
      - `similarity_threshold` number, required

## 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)