> ## Documentation Index > Fetch the complete documentation index at: https://docs.meshqu.com/llms.txt > Use this file to discover all available pages before exploring further. # Record decision > Evaluates policies AND persists the result with full audit trail. Supports idempotency: if the same idempotency_key is provided twice, returns the original decision without re-evaluating. Returns: - **decision**: The recorded decision with full context - **is_new**: False if returned from idempotency cache - **duration_ms**: Total request duration ## OpenAPI ````yaml /api/openapi.json post /v1/decisions/record openapi: 3.1.0 info: title: MeshQu API description: >- Governance infrastructure for policy-aware AI decisions. MeshQu does not run tools. It governs decisions about them. version: 1.9.0 contact: name: MeshQu Support email: support@meshqu.com license: name: Proprietary servers: - url: https://api.meshqu.com description: Deployed environment security: - apiKey: [] tenantId: [] tags: - name: Operations description: Health, readiness, metrics, and signing keys - name: Policies description: Policy management - name: Policy Groups description: Policy group management - name: Decisions description: Policy evaluation and recording - name: Chains description: Decision chain verification and sealing - name: Receipts description: Public receipt and bundle retrieval - name: Forms description: Attestation forms and public submission - name: Alerts description: Alert management and webhooks - name: Audit description: Audit log retrieval and verification - name: API Keys description: API key administration - name: Admin description: Tenant and platform administration - name: Dashboard description: Console dashboard data - name: Metrics description: Decision and overview metrics - name: Fields description: Field catalogue - name: Settings description: Tenant settings - name: Rule Creation Logs description: Rule authoring telemetry paths: /v1/decisions/record: post: tags: - Decisions summary: Record decision description: |- Evaluates policies AND persists the result with full audit trail. Supports idempotency: if the same idempotency_key is provided twice, returns the original decision without re-evaluating. Returns: - **decision**: The recorded decision with full context - **is_new**: False if returned from idempotency cache - **duration_ms**: Total request duration operationId: postV1DecisionsRecord requestBody: required: true content: application/json: schema: description: Request to record a decision with evaluation type: object properties: context: description: Canonical DecisionContext for policy evaluation type: object properties: decision_type: minLength: 1 description: Type of decision being evaluated type: string fields: description: Domain-agnostic field values for evaluation type: object additionalProperties: {} evidence: description: Supporting evidence for the decision type: array items: type: object properties: kind: description: >- Type of evidence (document, graph_query, external_api) type: string ref: description: Reference identifier for the evidence type: string hash: description: Content hash for verification type: string data: description: Additional evidence metadata type: object additionalProperties: {} required: - kind metadata: additionalProperties: true type: object properties: actor_id: description: Actor making the request type: string correlation_id: description: Request correlation ID type: string ip_address: description: IP address of the requestor type: string user_agent: description: User agent string type: string timestamp: format: date-time description: Request timestamp type: string source_artifact: description: Cryptographic binding to a source document type: object properties: type: description: Type of source artifact anyOf: - type: string enum: - PDF - type: string enum: - DOCX - type: string enum: - JSON_PAYLOAD - type: string enum: - IMAGE - type: string enum: - STRING - type: string enum: - OTHER hash: pattern: ^[a-f0-9]{64}$ description: >- SHA-256 hash of the artifact (64 lowercase hex characters) type: string hash_algorithm: description: Hash algorithm used (currently only SHA-256) type: string enum: - SHA-256 reference_id: maxLength: 255 description: Client reference ID for the artifact type: string filename: maxLength: 255 description: Original filename of the artifact type: string byte_size: minimum: 0 description: Size of the artifact in bytes type: integer required: - type - hash - hash_algorithm required: - decision_type - fields options: type: object properties: idempotency_key: minLength: 1 maxLength: 255 description: Unique key to prevent duplicate recordings type: string chain: description: Decision chain linkage for workflow/case grouping type: object properties: chain_id: format: uuid description: >- Chain ID to group this decision into an ordered sequence type: string chain_step: minimum: 1 description: >- Step number within the chain (auto-assigned if omitted) type: integer parent_decision_id: format: uuid description: >- Parent decision within the same chain (causal lineage) type: string required: - chain_id action: description: Action bound to this decision receipt type: object properties: type: description: >- Type of action authorized (e.g., payment_execute, loan_approve) type: string reference_id: description: Client's reference ID for the action (e.g., INV-88423) type: string metadata: description: Additional action metadata type: object additionalProperties: {} required: - type - reference_id actor: description: Actor attribution — who or what made this decision type: object properties: id: minLength: 1 maxLength: 255 description: Stable identifier for the actor type: string type: description: Whether the actor is human or automated anyOf: - type: string enum: - human - type: string enum: - automated role: maxLength: 255 description: >- Caller-defined role label (e.g., MLRO, compliance_analyst) type: string authority: maxLength: 255 description: Freeform authority context (e.g., final_disposition) type: string display_name: maxLength: 255 description: Human-readable name for UI/reports type: string required: - id - type evidence_manifest_digest: description: >- Evidence manifest digest — null or absent means no evidence is bound anyOf: - pattern: ^[0-9a-f]{64}$ description: >- SHA-256 hex digest (64 lowercase hex chars) of the canonical evidence manifest type: string - type: 'null' evidence_manifest: description: Full evidence manifest object — server stores and indexes it anyOf: - description: >- Multi-item evidence manifest bound to a governed decision additionalProperties: false type: object properties: manifest_version: description: Manifest schema version. Currently locked to "1". type: string enum: - '1' items: description: Evidence items examined for this decision type: array items: description: >- One artifact examined when making a governed decision additionalProperties: false type: object properties: kind: minLength: 1 description: >- Category of this evidence item (e.g. kyc_record, sanctions_screening_result). Named EvidenceItemKind values have UI labels; unknown strings are displayed verbatim. type: string mime_type: minLength: 1 description: >- IANA media type of the artifact (caller-attested) type: string byte_length: minimum: 0 description: >- Size of the artifact in bytes (caller-attested) type: integer source_system: minLength: 1 description: >- Identifier of the system that produced or holds the artifact type: string artifact_locator: description: >- Optional caller-attested pointer to the immutable, version-pinned artifact (additive v2.x) anyOf: - additionalProperties: false type: object properties: scheme: minLength: 1 description: >- Resolution scheme for uri (e.g. 's3', 'https', 'dms', 'cas') type: string uri: minLength: 1 description: >- Resolvable address of the artifact within the custodian environment type: string version_id: minLength: 1 description: >- Immutable version pin; MAY be omitted only when uri is content-addressed type: string required: - scheme - uri - type: 'null' retrieval_time: format: date-time description: >- ISO 8601 timestamp at which the artifact was retrieved from the source system type: string custodian_id: description: >- Identifier of the custodian that provided or attests to this artifact anyOf: - minLength: 1 type: string - type: 'null' normalization_profile: description: >- Identifier of the normalisation profile applied before hashing, if any anyOf: - minLength: 1 type: string - type: 'null' content_hash: pattern: ^[0-9a-f]{64}$ description: >- SHA-256 content hash of the artifact (64 lowercase hex chars) type: string signature: description: >- Optional Ed25519 custodian signature over this item anyOf: - description: >- Custodian signature over a single evidence item type: object properties: custodian_kid: minLength: 1 description: >- Key ID of the custodian signing key (opaque string; convention: /