---
title: "Update Conviction"
method: PUT
path: "/v1/benches/{token_address}/conviction"
tags: ["bench"]
---

# Update Conviction

`PUT /v1/benches/{token_address}/conviction`

## Request

- Base URL: `https://alive-api.alphakek.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://alive-api.alphakek.ai/v1/benches/{token_address}/conviction`
- Auth: none declared

Update or confirm conviction for a token.

If conviction is provided: saves creator's conviction (override).
If conviction is None: confirms the auto-generated conviction as-is.

Requires wallet_address matching the creator wallet from registration.
Only works before conviction is confirmed and before challenges are generated.

## Path parameters

- `token_address` string, required

## Request body

- UpdateConvictionRequest: Request to update/confirm conviction.
  - `wallet_address` string, required
  - `conviction` string, nullable

## Response `200`

Successful Response

- ConvictionStatusResponse: Response with conviction status for polling.
  - `status` string, required
  - `conviction` string, nullable
  - `source` string, nullable
  - `editable` boolean

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `b6d96e7673dc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alphakek-ai/apis/aikek-api/changes/v1/benches/:token_address/conviction/put.md)

---

[API](https://skmtc.dev/alphakek-ai/apis/aikek-api.md) - [All operations](https://skmtc.dev/alphakek-ai/apis/aikek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alphakek-ai/apis/aikek-api/revisions/b6d96e7673dc?raw)