Skip to main content
POST
Spend an approved confirmation of one MCP call

Authorizations

Authorization
string
header
required

A Personal key (fmcp_…), bound to the person who created it, or an interactive MCP sign-in that resolves to one. Pass as Authorization: Bearer <key>. It acts for that person, under their role grants narrowed by its scopes; an operation that acts for a person admits only this kind.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key repeat within 24 hours is refused (409 idempotency_result_unavailable) rather than replayed: ask again without the key.

Required string length: 1 - 255

Path Parameters

confirmationId
string
required
Required string length: 1 - 256

Body

application/json
callDigest
string
required

The call's digest: base64url (no padding) of SHA-256 over "forge-mcp/confirm/v1\n" + tool + "\n" + canonical JSON of the arguments.

Pattern: ^[A-Za-z0-9_-]{43}$

Response

Whether the confirmation was spent

data
object
required
meta
object
required