> ## Documentation Index > Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt > Use this file to discover all available pages before exploring further. # Activate an optimized judge prompt > Makes this optimization candidate the active revision: it takes the source metric's name, description and tags, the source's specifications and user groups are linked to it too, and the source becomes legacy — all in one step. Repeating it on a candidate already activated returns 200 with the metric and changes nothing. Rejected with 400 if the candidate was declined or is otherwise not waiting for review, if the source changed since the candidate was created (revised, deleted, or already flipped legacy), or if the source's judge model is no longer selectable. ## OpenAPI ````yaml https://api.galtea.ai/openapi.json post /metrics/{id}/activate-optimization openapi: 3.0.0 info: version: 1.0.0 title: Product Management Service API description: API documentation for Product Management Service contact: name: Galtea AI servers: - url: https://api.galtea.ai security: - bearerAuth: [] tags: [] externalDocs: description: Galtea Platform Documentation url: https://docs.galtea.ai paths: /metrics/{id}/activate-optimization: post: tags: - metrics summary: Activate an optimized judge prompt description: >- Makes this optimization candidate the active revision: it takes the source metric's name, description and tags, the source's specifications and user groups are linked to it too, and the source becomes legacy — all in one step. Repeating it on a candidate already activated returns 200 with the metric and changes nothing. Rejected with 400 if the candidate was declined or is otherwise not waiting for review, if the source changed since the candidate was created (revised, deleted, or already flipped legacy), or if the source's judge model is no longer selectable. operationId: activateMetricOptimization parameters: - schema: type: string minLength: 1 description: Optimization candidate metric ID required: true description: Optimization candidate metric ID name: id in: path responses: '200': description: The activated metric content: application/json: schema: $ref: '#/components/schemas/Metric' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: Metric: type: object properties: id: type: string example: metric_123 metricGroupId: type: string readOnly: true example: metric_123 description: >- Identifier shared by every metric in the same revision family. Server-managed — derived from `parentMetricId` on create (or generated for roots). Cannot be set by the caller. parentMetricId: type: string nullable: true example: metric_122 description: >- Id of the direct parent metric. On create, providing this value turns the new metric into a revision: it joins the parent's family and (if the parent is active) flips the parent to legacy. Omit or null to create a root metric in a fresh group. On responses, this is the recorded parent edge (null for roots). organizationId: type: string nullable: true example: org_123 userId: type: string nullable: true example: user_123 name: type: string example: Accuracy evaluationParams: type: array items: type: string example: - input - actual_output - expected_output description: >- Ordered list of trace fields the evaluator needs, written in snake_case (e.g. `input`, `actual_output`, `expected_output`, `retrieval_context`). Determines which data the evaluation engine extracts from each trace. Full list of accepted values: https://docs.galtea.ai/concepts/metric/evaluation-parameters source: type: string enum: - SELF_HOSTED - FULL_PROMPT - PARTIAL_PROMPT - HUMAN_EVALUATION - GEVAL - DEEPEVAL - DETERMINISTIC nullable: true example: PARTIAL_PROMPT description: >- Evaluation method for the metric. `FULL_PROMPT` is deprecated for creation — `POST /metrics` rejects it with a 400. Use `PARTIAL_PROMPT` for new AI Evaluation metrics. The value remains in the enum because existing FULL_PROMPT metrics are still returned by reads and filters. judgePrompt: type: string nullable: true example: Evaluate the accuracy of the response tags: type: array items: type: string example: - accuracy - quality description: type: string nullable: true example: Measures the accuracy of responses documentationUrl: type: string nullable: true example: https://docs.example.com/metrics/accuracy evaluatorModelName: type: string nullable: true example: GPT-4 areEvalParamsTop: type: boolean nullable: true description: >- When true, evaluationParams are injected at the top level of the evaluator prompt instead of nested inside the conversation context. isBeingOptimized: type: boolean readOnly: true description: Whether the metric is currently being optimized. optimizationStatus: type: string nullable: true enum: - OPTIMIZING - READY_FOR_REVIEW - FAILED - NO_IMPROVEMENT - DECLINED - ACTIVATED readOnly: true example: READY_FOR_REVIEW description: >- Where an optimization attempt stands. Null for a metric that did not come from an optimization. A candidate waiting for review is legacy until it is activated. judgeGenerationSettings: type: object nullable: true properties: temperature: type: number nullable: true minimum: 0 example: 0.3 topP: type: number nullable: true minimum: 0 maximum: 1 example: 0.9 maxOutputTokens: type: integer nullable: true minimum: 1 example: 512 reasoningEffort: type: string nullable: true example: low additionalProperties: false description: >- The generation settings this metric's judge runs with. Null runs the platform defaults. Immutable: changing one creates a revision. optimizationValidation: type: object nullable: true properties: used: type: boolean description: >- Whether any evaluation was held out for validation. False when none was: too few annotated evaluations and no session kept from an earlier attempt, or no session was eligible for the hold-out. heldOutEvaluationIds: type: array items: type: string description: >- Evaluations held out of the search. Empty when no validation set was used. example: - evaluation_123 results: type: object nullable: true properties: optimization: type: object properties: rowsScored: type: integer minimum: 0 description: Rows both prompts scored. Only these rows are compared. example: 25 rowsTotal: type: integer minimum: 0 description: Rows in the set. example: 25 source: type: object properties: correct: type: integer minimum: 0 description: >- Rows where the AI verdict matches the human label. A score of 0.5 or above is a positive verdict. example: 20 alignment: type: number nullable: true description: >- Alignment between the AI scores and the human labels on the compared rows. Null when undefined. example: 0.71 required: - correct - alignment additionalProperties: false candidate: type: object properties: correct: type: integer minimum: 0 description: >- Rows where the AI verdict matches the human label. A score of 0.5 or above is a positive verdict. example: 20 alignment: type: number nullable: true description: >- Alignment between the AI scores and the human labels on the compared rows. Null when undefined. example: 0.71 required: - correct - alignment additionalProperties: false required: - rowsScored - rowsTotal - source - candidate additionalProperties: false validation: type: object properties: rowsScored: type: integer minimum: 0 description: Rows both prompts scored. Only these rows are compared. example: 25 rowsTotal: type: integer minimum: 0 description: Rows in the set. example: 25 source: type: object properties: correct: type: integer minimum: 0 description: >- Rows where the AI verdict matches the human label. A score of 0.5 or above is a positive verdict. example: 20 alignment: type: number nullable: true description: >- Alignment between the AI scores and the human labels on the compared rows. Null when undefined. example: 0.71 required: - correct - alignment additionalProperties: false candidate: type: object properties: correct: type: integer minimum: 0 description: >- Rows where the AI verdict matches the human label. A score of 0.5 or above is a positive verdict. example: 20 alignment: type: number nullable: true description: >- Alignment between the AI scores and the human labels on the compared rows. Null when undefined. example: 0.71 required: - correct - alignment additionalProperties: false required: - rowsScored - rowsTotal - source - candidate additionalProperties: false required: - optimization - validation additionalProperties: false description: >- Both prompts scored on the rows the search used and on the held-out rows. Null when the optimizer reported nothing. rows: type: array nullable: true items: type: object properties: evaluationId: type: string example: evaluation_123 humanScore: type: number description: The human label. example: 1 sourceScore: type: number nullable: true description: >- The source prompt's judge score on this row, or null when it failed. A score of 0.5 or above is a positive verdict. example: 0 candidateScore: type: number nullable: true description: >- The optimized prompt's judge score on this row, or null when it failed. A score of 0.5 or above is a positive verdict. example: 1 required: - evaluationId - humanScore - sourceScore - candidateScore additionalProperties: false description: >- One entry per held-out row the optimizer reported; a score is null when that prompt failed on the row. Null when the optimizer reported nothing. required: - used - heldOutEvaluationIds - results - rows additionalProperties: false readOnly: true description: >- How an optimization attempt was validated: the held-out evaluations and, once the optimizer reported, both prompts scored on the search rows and on the held-out rows. Set on an optimization attempt only, and null for any other metric, for an attempt that predates it, and for an attempt copied from another organization. specificationIds: type: array items: type: string example: - spec_123 userGroupIds: type: array items: type: string example: - ug_123 createdAt: type: string format: date-time legacyAt: type: string nullable: true format: date-time readOnly: true description: >- Earliest non-null of this metric's own legacy date and its evaluator model's `unselectableAt`, so a model no longer selectable makes every metric linked to it report as legacy even though the metric row itself is untouched. Present only once that date has passed: a scheduled future cutoff reports null, because the metric is still active until then. Unlike `disabledAt`, this field never carries a future date. disabledAt: type: string nullable: true format: date-time readOnly: true description: >- Earliest non-null of this metric's own disabled date and its evaluator model's `disabledAt` — a disabled model makes every metric linked to it report as disabled even though the metric row itself is untouched. excludedFromAnalyticsAt: type: string nullable: true format: date-time readOnly: true description: >- When set, results produced by this metric revision do not feed analytics. excludedByUserId: type: string nullable: true readOnly: true description: User who last excluded this metric revision from analytics. required: - id - metricGroupId - parentMetricId - organizationId - userId - name - evaluationParams - source - judgePrompt - tags - description - documentationUrl - evaluatorModelName - areEvalParamsTop - isBeingOptimized - optimizationStatus - judgeGenerationSettings - optimizationValidation - specificationIds - userGroupIds - createdAt - legacyAt - disabledAt - excludedFromAnalyticsAt - excludedByUserId Error: type: object properties: error: type: string example: Error type message: type: string example: Error message description securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (`gsk_*`) and legacy (`gsk-`) API keys are accepted, e.g. `Authorization: Bearer gsk_...` or `Authorization: Bearer gsk-...`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.