---
title: "Sign Score Update"
method: POST
path: "/api/acs/oracle/sign-score"
tags: ["ACS Oracle"]
---

# Sign Score Update

`POST /api/acs/oracle/sign-score`

## Request

- Base URL: `https://api.kojiru.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kojiru.com/api/acs/oracle/sign-score`
- Auth: HTTP bearer

Sign a ScoreUpdate so it can be broadcast to `KojiruACSOracle.applySignedScoreUpdate(...)`.

If `nonce` is omitted, the next valid nonce is fetched from chain.

## Request body

- SignRequest
  - `agent_id` integer, required: ERC-8004 IdentityRegistry tokenId for the agent.
  - `new_score` integer, required: ACS in [300, 850].
  - `expires_at` integer, required: Unix seconds after which the oracle will reject this attestation.
  - `evidence_hash` string, required: 32-byte keccak hash of the signed input bundle, as 0x-prefixed hex.
  - `nonce` integer, nullable

## Response `200`

Successful Response

- SignResponse
  - `agent_id` integer, required
  - `new_score` integer, required
  - `nonce` integer, required
  - `expires_at` integer, required
  - `evidence_hash` string, required
  - `digest` string, required
  - `signature` string, required
  - `signer_address` string, required
  - `chain_id` integer, required
  - `verifying_contract` string, required
  - `issued_at` string, required

## Other responses

- `422`: Validation Error

---

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