Skip to main content
POST
Ask for a confirmation of one destructive MCP call

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

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

Body

application/json
tool
string
required

The MCP tool being called.

Required string length: 1 - 120
operationId
string
required

The Platform API operation the call reaches.

Required string length: 1 - 120
method
enum<string>
required

That operation's method.

Available options:
GET,
POST,
PUT,
PATCH,
DELETE
path
string
required

That operation's OpenAPI path template. Its route declaration, not this request, decides the permissions the confirmation needs.

Required string length: 1 - 300
Pattern: ^\/api\/v2\/
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}$
summary
string
required

What the call does, in a few words.

Required string length: 1 - 200
consequence
string
required

What cannot be undone, with no ids.

Required string length: 1 - 300
effect
string
required

The MCP server's sentence about the call.

Required string length: 1 - 600
references
object[]
required

Records the call touches; the Console names them.

Maximum array length: 4
inputPreview
string
required

The call's arguments, shortened.

Maximum string length: 301

Response

The confirmation, or the credential's preauthorization

data
object
required
meta
object
required