---
title: "POST /v1/decisions/evaluate"
method: POST
path: "/v1/decisions/evaluate"
---

# POST /v1/decisions/evaluate

`POST /v1/decisions/evaluate`

## Request

- Base URL: `https://thumbgate.ai`
- URL: `https://thumbgate.ai/v1/decisions/evaluate`
- Auth: HTTP bearer

## Request body

- object
  - `toolName` string: Tool name is optional when provider-native tool call payload is supplied.
  - `source` 'chatgpt_gpt': Attribution marker for ThumbGate analytics. The published ThumbGate GPT should send `chatgpt_gpt` so owner dashboards can distinguish GPT Action calls from local API calls.
  - `provider` string
  - `model` string
  - `providerToolCall` object
  - `toolCall` object
  - `toolUse` object
  - `content` object[]
  - `input` object
  - `arguments` object
  - `method` string
  - `params` object
  - `mcp` object
  - `mcpToolCall` object
  - `usage` object
  - `tokenEstimate` number
  - `costUsd` number
  - `budget` object
  - `workflowPattern` 'single_action' | 'chaining' | 'routing' | 'parallelization' | 'evaluator-optimizer' | 'agent'
  - `workflow` object
  - `goal` string
  - `tools` string[]
  - `branches` string[]
  - `steps` string[]
  - `routes` string[]
  - `command` string
  - `filePath` string
  - `changedFiles` string[]
  - `repoPath` string
  - `baseBranch` string
  - `requirePrForReleaseSensitive` boolean
  - `requireVersionNotBehindBase` boolean
  - `workflowDispatch` object: Evidence required before running `gh workflow run` or another environment-specific workflow dispatch.
    - `environment` string: Requested environment such as dev, staging, beta, or release.
    - `workflow` string: Expected workflow file or workflow name.
    - `ref` string: Expected branch or ref passed to the workflow dispatch command.
    - `sha` string: Expected HEAD SHA to verify before and after dispatch.
    - `job` string: Expected job name to verify before reporting the workflow URL.

## Response `200`

Persisted workflow-sentinel recommendation with decision-control metadata and actionId

- object

## Other responses

- `400`: Invalid decision evaluation request
- `401`: Unauthorized

---

[API](https://skmtc.dev/thumbgate/apis/thumbgate-api.md) · [All operations](https://skmtc.dev/thumbgate/apis/thumbgate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thumbgate/apis/thumbgate-api/revisions/7f57f2edcd23?raw)