---
title: "Attach a counterparty acknowledgment"
method: POST
path: "/api/records/{record_id}/acknowledge"
tags: ["Verification Records"]
---

# Attach a counterparty acknowledgment

`POST /api/records/{record_id}/acknowledge`

## Request

- Base URL: `https://flint.network`
- URL: `https://flint.network/api/records/{record_id}/acknowledge`
- Auth: none required

Stores bounded counterparty acknowledgment evidence beside the immutable record. Unsupported or invalid signatures are retained as unverified claims and are never represented as cryptographically verified.

## Path parameters

- `record_id` string, required

## Request body

- RecordAcknowledgmentRequest
  - `acknowledger` object, required
    - `agent_id` string, required
    - `passport_id` string
    - `wallet_address` string
  - `payload_hash` string, required
  - `signature` object
    - `alg` string, required: ES256 or EIP-191 are verifiable; other values are retained as unsupported claims.
    - `value` string, required
    - `jwk` object: Only a public JWK can produce verified status. A JWK containing private members is retained as an unverified claim.

## Response `201`

Acknowledgment stored.

- RecordAcknowledgmentResponse
  - `ok` unknown, required
  - `record_id` string, required
  - `signature_status` 'verified' | 'unverified_claim', required
  - `received_at` string, date-time, required
  - `acknowledgment` RecordAcknowledgment, required
    - `received_at` string, date-time, required
    - `acknowledger` object, required
      - `agent_id` string, required
      - `passport_id` string, nullable, required
      - `wallet_address` string, nullable, required
    - `signature_status` 'verified' | 'unverified_claim', required
    - `method` 'none' | 'es256_jws' | 'eip191_wallet' | 'unsupported', required

## Other responses

- `400`: Invalid request
- `404`: Resource not found
- `429`: Acknowledgment submission rate limited.

---

[API](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api.md) · [All operations](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/revisions/eb5052b7b5dc?raw)