---
title: "Invoke"
method: POST
path: "/scorers/invoke"
tags: ["scorer"]
---

# Invoke

`POST /scorers/invoke`

## Request body

- ScoringInvokeRequest
  - `scorer_label` string, nullable
  - `scorer_id` string, uuid4, nullable
  - `scorer_version_id` string, uuid4, nullable
  - `inputs` ScoringInvokeInputs, required
    - `query` union
      - union
        - boolean
        - integer
        - number
        - string
      - JsonLike[]
      - object
    - `response` union
      - union
        - boolean
        - integer
        - number
        - string
      - JsonLike[]
      - object
    - `ground_truth` union
      - union
        - boolean
        - integer
        - number
        - string
      - JsonLike[]
      - object
    - `tools` union
      - union
        - boolean
        - integer
        - number
        - string
      - JsonLike[]
      - object
  - `config` object, nullable

## Response `200`

Successful Response

- ScoringInvokeResponse
  - `scorer_label` string, nullable
  - `score` union
    - number
    - integer
    - boolean
    - string
    - object
    - unknown[]
      - unknown
  - `status` 'success' | 'timeout' | 'failed' | 'error'
  - `execution_time` number, nullable
  - `error_message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)