> ## 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 outcome > Records what happened after a decision verdict. Expected for REVIEW decisions. Optional for DENY/ALERT. Rare for ALLOW. One outcome per decision — subsequent attempts return 409. ## OpenAPI ````yaml /api/openapi.json post /v1/decisions/{id}/outcome 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/{id}/outcome: post: tags: - Decisions summary: Record decision outcome description: |- Records what happened after a decision verdict. Expected for REVIEW decisions. Optional for DENY/ALERT. Rare for ALLOW. One outcome per decision — subsequent attempts return 409. operationId: postV1DecisionsByIdOutcome parameters: - schema: format: uuid type: string in: path name: id required: true description: Decision ID requestBody: required: true content: application/json: schema: description: Request to record a decision outcome type: object properties: status: description: Outcome status anyOf: - type: string enum: - accepted - type: string enum: - overridden - type: string enum: - escalated - type: string enum: - expired - type: string enum: - abandoned final_action: description: Final action taken (only meaningful when overridden) anyOf: - type: string enum: - ALLOW - type: string enum: - DENY - type: string enum: - NO_ACTION source_type: description: Source of the outcome report anyOf: - type: string enum: - human - type: string enum: - external_system - type: string enum: - agent reported_by: minLength: 1 description: Who reported this outcome type: string reported_at: format: date-time description: When the outcome was reported (defaults to now) type: string resolution_reason: description: >- Freeform reason for the resolution (not the same as violation reason_code) type: string notes: description: Additional notes type: string external_reference: description: External system reference (e.g., ticket ID) type: string required: - status - source_type - reported_by description: Request to record a decision outcome responses: '201': description: A recorded decision outcome content: application/json: schema: description: A recorded decision outcome type: object properties: id: format: uuid type: string decision_id: format: uuid type: string tenant_id: format: uuid type: string status: anyOf: - type: string enum: - accepted - type: string enum: - overridden - type: string enum: - escalated - type: string enum: - expired - type: string enum: - abandoned final_action: anyOf: - type: string enum: - ALLOW - type: string enum: - DENY - type: string enum: - NO_ACTION - type: 'null' source_type: anyOf: - type: string enum: - human - type: string enum: - external_system - type: string enum: - agent reported_by: type: string reported_at: format: date-time type: string resolution_reason: anyOf: - type: string - type: 'null' notes: anyOf: - type: string - type: 'null' external_reference: anyOf: - type: string - type: 'null' created_at: format: date-time type: string required: - id - decision_id - tenant_id - status - final_action - source_type - reported_by - reported_at - resolution_reason - notes - external_reference - created_at '400': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: description: Error code type: string message: description: Human-readable message type: string details: description: Additional error details required: - code - message correlation_id: description: Request correlation ID type: string required: - error '404': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: description: Error code type: string message: description: Human-readable message type: string details: description: Additional error details required: - code - message correlation_id: description: Request correlation ID type: string required: - error '409': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: description: Error code type: string message: description: Human-readable message type: string details: description: Additional error details required: - code - message correlation_id: description: Request correlation ID type: string required: - error components: securitySchemes: apiKey: type: http scheme: bearer bearerFormat: mqu_ description: >- MeshQu API key passed as a bearer token: `Authorization: Bearer mqu_…`. Mint one in the console (Settings → API keys). tenantId: type: apiKey name: X-MeshQu-Tenant-Id in: header description: >- Tenant UUID for multi-tenant isolation. Required on all authenticated routes — validated before authentication (middleware/tenant.ts), so a missing or non-UUID header returns 400 (MISSING_TENANT_ID / INVALID_TENANT_ID) before the API key is checked. ````