---
search:
  tags:
    - proposals
    - POST
seo:
  description: >-
    Commit an accepted, allowlisted proposal idempotently (scope… Reference for
    the POST /api/v1/proposals/{id}/commit endpoint in the Basenet Public API.
sidebar:
  label: >-
    Commit an accepted, allowlisted proposal idempotently (scope
    proposals:write)
  badge: POST
title: Commit an accepted, allowlisted proposal idempotently (scope proposals:write)
type: openapi-operation
---
Endpoint: `POST /api/v1/proposals/{id}/commit`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Parameters:
- `id` (in path, string, required)

Request body (`application/json`):
- `idempotencyKey` (string, required)

Responses:
- `200`: Previously committed result replayed
- `201`: Proposal committed
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `404`: Not found
- `409`: Acceptance conflict or duplicate relation matches
- `410`: Proposal expired
- `429`: Rate limited
- `502`: Capability execution failed

Response 200 body (`application/json`): object or object or object or object

Response 201 body (`application/json`): object or object or object or object