For developers

Make a governed call
in four lines.

The call
from muraqib_client import MuraqibClient

client = MuraqibClient(api_key=MURAQIB_API_KEY)

decision = client.clear(
    action_type="EXTERNAL_CORRESPONDENCE",
    summary="Reply to an external enquiry (example)",
    request_ref="EXAMPLE-REF-0001",
)

if not decision.approved:
    raise SystemExit(decision.reason)
What comes back — illustrative example, not a real record
decision.decision      # 'ESCALATED'
decision.approved      # False
decision.escalated     # True
decision.governed      # True
decision.evidence_id   # 'EVD-EXAMPLE1'
decision.reason        # 'EXC-01: External correspondence —
                       #  human authorization before dispatch'

ESCALATED means a person must authorise it. The record is sealed either way — that is what governed attests.

Show an example record — 34 fields

Illustrative example — not a real record. Every identifier and hash below is fictional; the field names and their order are the real sealed-record format. Real records are verified from an evidence bundle using the open-source verifier; bundles are issued by OQIRON on request.

{
  "evidence_id":           "EVD-EXAMPLE1",
  "decision":              "ESCALATED",
  "rule_triggered":        "EXC-01",
  "rule_name_en":          "External correspondence — dispatch authorization",
  "rule_name_ar":          "اعتماد المراسلات الخارجية قبل الإرسال",
  "safe_action":           "EXC-01: external correspondence requires human
                            authorization before dispatch",
  "action_type":           "EXTERNAL_CORRESPONDENCE",
  "requires_approval":     "true",
  "risk_level":            "LOW",
  "risk_score":            "0.33",
  "data_sensitivity":      "MEDIUM",
  "is_external":           "true",
  "contains_pii":          "false",
  "has_attachment":        "false",
  "regulatory_risk":       "false",
  "financial_amount":      "0",
  "priority":              "NORMAL",
  "token_cost":            "0",
  "policy_digest":         "307f6aebd32bb11568343ba6b806bd82edd1c0747b9f60534f9be762ec3f876e",
  "created_at":            "2026-10-01T09:00:00.000000+00:00",
  "signature_verified":    null,
  "signature_reject_reason": null,
  "assertion_sig":         null,
  "assertion_body":        null,
  "assertion_key_id":      null,
  "assertion_ts":          null,
  "assertion_bind_version": null,
  "action_summary":        "[generated] EXTERNAL_CORRESPONDENCE re: EXAMPLE-REF-0001 | attachment=no",
  "agent_id":              "SANDBOX-EXAMPLE-001",
  "agent_name":            "Example correspondence agent",
  "actor_id":              "EXAMPLE-USER-01",
  "actor_name":            "Example User",
  "request_ref":           "EXAMPLE-REF-0001",
  "tenant_id":             "TEN-EXAMPLE"
}

In a real record the last seven fields carry the agent and actor identities, the request reference and the tenant. That is why evidence bundles are issued on request rather than self-served: a bundle can disclose who acted, for whom, and on what reference.

Install
pip install git+https://github.com/oqiron/muraqib-sdk.git@v2.3.1

No configuration. The client defaults to https://muraqib.oqiron.ai.
Set MURAQIB_API_KEY to the key we send you.
Your agent id comes from the key — never send it in the body.

Request sandbox access

A person reviews each request, usually within one business day. You receive an agent id, a tenant id and an API key. Sandbox actions never enter the production chain.