Skip to main content

​
Status

/execute is a legacy endpoint.New integrations should use:
  1. GET Policy Schema
  2. POST /evaluate
  3. POST /override (when required)
  4. POST /confirm-execution

​
Why The Workflow Changed

Parmana’s architecture evolved to separate:
  • Policy evaluation
  • Human override
  • Execution confirmation
This provides stronger authority verification and better auditability. Instead of a single execution step: 
Request
    ↓
Execute
Parmana now uses: 
Verified Signals
        ↓
Evaluate
        ↓
Override (optional)
        ↓
Execution
        ↓
Confirm Execution

​
Step 1

Retrieve the policy schema. 
GET /policies/{policyId}/versions/{version}/schema

​
Step 2

Collect and verify required signals. 
{
  "insurance_active": true,
  "risk_score": 10,
  "claim_amount": 100
}

​
Step 3

Evaluate policy. 
POST /evaluate
Response: 
{
  "status": "approved",
  "attestation": {
    "...": "..."
  }
}

​
Step 4

If required, perform override. 
POST /override

​
Step 5

Execute the action. 
Payment
Claim Approval
Account Change
Transfer
Execution occurs in the external system.

​
Step 6

Confirm execution. 
POST /confirm-execution
Response: 
{
  "match": true,
  "verified": true
}

​
Why Separation Matters

​
Authorization

Was the action authorized?
Answered by: 
POST /evaluate

​
Human Authority

Did an authorized human approve an exception?
Answered by: 
POST /override

​
Execution Integrity

Did the executed action match the authorized action?
Answered by: 
POST /confirm-execution

​
Architecture

Customer Chooses Task
        ↓
Task → Policy Mapping
        ↓
Policy Schema
        ↓
Verified Signals
        ↓
Parmana Evaluation
        ↓
Decision
        ↓
Override (optional)
        ↓
Execution
        ↓
Execution Integrity Proof

​
Migration Guidance

If you currently use /execute:

​
Before

Request
    ↓
Execute

​
After

Request
    ↓
Evaluate
    ↓
Override (optional)
    ↓
Execute
    ↓
Confirm Execution
This produces:
  • Signed attestation
  • Override evidence
  • Execution Integrity Proof
  • Independent verification capability

​
Policy Schema

GET /policies/{policyId}/versions/{version}/schema

​
Evaluate

POST /evaluate

​
Override

POST /override

​
Confirm Execution

POST /confirm-execution

​
Verify

POST /verify

​
Parmana Architecture

Parmana separates: 
Authority Verification
from 
Execution
AI can request actions. Policies define authority. Humans retain authority. Parmana verifies authority before execution and produces verifiable evidence after execution.