**API versions** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=en)

# Insight

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

## Operations

## GET /insight/context

Read the consenting user’s Insight frame

`get_insight_context`

OAuth only with fresh, explicit, personal Insight consent. Manual, root/system, old OAuth and contact-suggestion grants are refused, including for administrators. Never supply actor, owner or organisation; the server binds the consenting user and organisation. Private constraints and enrichment remain private to that user. Current token, consent, scopes and native rights are reread before entry and publication. I1 reads no CRM source and requires no CRM source scope. GET is passive and never starts analysis, activation or notification. Unknown fields are refused.

Returns common mission/context, this user’s personal frame, permission to edit common and onboarding status. local/global is a declared population preference, never an access grant. Confirmation does not activate Insight; activation awaits the first qualified report.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:read",
  "additional": []
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private result.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightContextResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/context/common

Update the common Insight frame

`update_insight_common_context`

OAuth only with fresh, explicit, personal Insight consent. Manual, root/system, old OAuth and contact-suggestion grants are refused, including for administrators. Never supply actor, owner or organisation; the server binds the consenting user and organisation. Private constraints and enrichment remain private to that user. Current token, consent, scopes and native rights are reread before entry and publication. I1 reads no CRM source and requires no CRM source scope. GET is passive and never starts analysis, activation or notification. Unknown fields are refused.

Read the current revision first; expectedRevision is the exact revision being edited, 0 for an absent frame. Only supplied patch fields change; omissions preserve values. Keep the UUID operationKey for the exact intention across retries. A conflict requires rereading and deliberate reconciliation. Receipt contains no context text. With insight:configure alone, recover by replaying the exact same command payload, operationKey and expectedRevision; the GET receipt endpoint separately requires insight:read.

Requires current native ADMIN rights. Supply at least mission or context; mission must contain non-whitespace text; context may be cleared.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:configure",
  "additional": []
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "mission": {
            "type": "string",
            "minLength": 1,
            "maxLength": 8000,
            "pattern": "\\S"
          },
          "context": {
            "type": "string",
            "maxLength": 16000
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "mission"
            ]
          },
          {
            "required": [
              "context"
            ]
          }
        ]
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private result.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:configure",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/context/personal

Update the consenting user’s personal Insight frame

`update_insight_personal_context`

OAuth only with fresh, explicit, personal Insight consent. Manual, root/system, old OAuth and contact-suggestion grants are refused, including for administrators. Never supply actor, owner or organisation; the server binds the consenting user and organisation. Private constraints and enrichment remain private to that user. Current token, consent, scopes and native rights are reread before entry and publication. I1 reads no CRM source and requires no CRM source scope. GET is passive and never starts analysis, activation or notification. Unknown fields are refused.

Read the current revision first; expectedRevision is the exact revision being edited, 0 for an absent frame. Only supplied patch fields change; omissions preserve values. Keep the UUID operationKey for the exact intention across retries. A conflict requires rereading and deliberate reconciliation. Receipt contains no context text. With insight:configure alone, recover by replaying the exact same command payload, operationKey and expectedRevision; the GET receipt endpoint separately requires insight:read.

Supply at least one personal field. primaryPriority=null clears it in an unconfirmed draft; a confirmed frame must retain audience and a primary priority; dueOn is a civil YYYY-MM-DD date or null. Secondary priorities never replace the required primary priority. Constraints/enrichment are optional and private. Use this command to save onboarding answers before confirmation.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:configure",
  "additional": []
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_86acc4db603dce0726a0"
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private result.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:configure",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/onboarding

Read Insight onboarding readiness

`get_insight_onboarding`

OAuth only with fresh, explicit, personal Insight consent. Manual, root/system, old OAuth and contact-suggestion grants are refused, including for administrators. Never supply actor, owner or organisation; the server binds the consenting user and organisation. Private constraints and enrichment remain private to that user. Current token, consent, scopes and native rights are reread before entry and publication. I1 reads no CRM source and requires no CRM source scope. GET is passive and never starts analysis, activation or notification. Unknown fields are refused.

Returns readiness and missing minimum fields only. Optional answers are never required. It does not start an interview or calculate a report.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:read",
  "additional": []
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private result.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightOnboardingResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/onboarding/confirmation

Confirm the minimum Insight frame

`confirm_insight_onboarding`

OAuth only with fresh, explicit, personal Insight consent. Manual, root/system, old OAuth and contact-suggestion grants are refused, including for administrators. Never supply actor, owner or organisation; the server binds the consenting user and organisation. Private constraints and enrichment remain private to that user. Current token, consent, scopes and native rights are reread before entry and publication. I1 reads no CRM source and requires no CRM source scope. GET is passive and never starts analysis, activation or notification. Unknown fields are refused.

Read the current revision first; expectedRevision is the exact revision being edited, 0 for an absent frame. Only supplied patch fields change; omissions preserve values. Keep the UUID operationKey for the exact intention across retries. A conflict requires rereading and deliberate reconciliation. Receipt contains no context text. With insight:configure alone, recover by replaying the exact same command payload, operationKey and expectedRevision; the GET receipt endpoint separately requires insight:read.

Save common/personal answers first, then provide expectedCommonRevision and the personal expectedRevision. Mission, audience and a primary priority are required; constraints and enrichment are optional. Confirmation creates a private versioned snapshot and stays awaiting_initial_report.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:configure",
  "additional": []
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "expectedCommonRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "expectedCommonRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private result.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:configure",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/operations/{operationKey}

Recover an exact Insight operation receipt

`get_insight_operation`

OAuth only with fresh, explicit, personal Insight consent. Manual, root/system, old OAuth and contact-suggestion grants are refused, including for administrators. Never supply actor, owner or organisation; the server binds the consenting user and organisation. Private constraints and enrichment remain private to that user. Current token, consent, scopes and native rights are reread before entry and publication. I1 reads no CRM source and requires no CRM source scope. GET is passive and never starts analysis, activation or notification. Unknown fields are refused.

Select common or personal scope and the same operationKey used for the command. Reads only this user’s exact receipt, including common commands authored by this user. No context text. Not found is not proof that an interrupted write cannot still finish; preserve the key.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:read",
  "additional": []
}
```

### Parameters

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

```json
{
  "name": "scope",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "common",
      "personal"
    ]
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private result.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Input refused, rights/consent revoked, revision conflict, incomplete minimum or unavailable result. INSIGHT_COMMAND_UNCERTAIN means the write may have entered: recover its exact receipt before retrying.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/analyses

Request a private Insight analysis

`request_insight_analysis`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Explicitly queues a prepared analysis and may incur model cost. Save and confirm the minimum frame first. Provide the exact current common and personal revisions. Omitted language defaults to fr. acceptedAt/status=queued is an immutable acceptance receipt, never proof of a ready report. Reuse the same UUID operationKey, payload, revisions and language for recovery. insight:analyses:request plus insight:read permits exact command replay without insight:analyses:read; GET status/result separately requires insight:analyses:read. A conflict requires deliberate reconciliation.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:request",
  "additional": [
    "insight:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedCommonRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "expectedPersonalRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro"
            ],
            "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
          }
        },
        "required": [
          "operationKey",
          "expectedCommonRevision",
          "expectedPersonalRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:request",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/analyses/current

Read the current private Insight analysis

`get_current_insight_analysis`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Reads the latest admissible result for this person, language and exact source view. missing/pending/failed/stale are explicit states, never an empty successful report. Inspect coverage and caveats. A ready result may contain zero topics. No fallback to a wider or another person’s view.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "language",
  "in": "query",
  "required": false,
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "de",
      "es",
      "gr",
      "ro"
    ],
    "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/analyses/{id}

Read one private Insight analysis state

`get_insight_analysis`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Opaque job ID from the acceptance receipt; does not grant access. queued/running is not ready. Ready results require current frame/source admission and exact source view. The acceptance receipt remains queued even when the job is ready.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/topics

List topics in the current private Insight analysis

`list_insight_topics`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Returns at most five currently prepared topics and the analysis state; this is not historical pagination or a count of all opportunities. Zero topics can be a qualified result. Proposals require human review and are not actions already done. When present, reviewAction is a separate server review identity for personal feedback; a free-form proposed call/message is never that action. summary.mode=facts_only carries no current topic recommendation; admitted_topics summarizes only admitted topics.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "language",
  "in": "query",
  "required": false,
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "de",
      "es",
      "gr",
      "ro"
    ],
    "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisTopicsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/topics/{id}

Read one current private Insight topic

`get_insight_topic`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Topic ID is opaque and scoped to the current admissible analysis in the selected language. Evidence IDs refer to that analysis; use its analysis ID and get_insight_evidence to read one currently admitted citation. Does not read arbitrary sources.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 250
  }
}
```

```json
{
  "name": "language",
  "in": "query",
  "required": false,
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "de",
      "es",
      "gr",
      "ro"
    ],
    "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisTopicStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/analyses/{id}/evidence/{evidenceId}

Read one currently admitted Insight evidence item

`get_insight_evidence`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Reads an exact evidence ID inside this currently admissible ready analysis. Inaccessible, stale, another-owner or missing evidence returns not found; never accepts a collection/contact selector. Declared data is not independently observed; prepared_suggestion is not completed action. Civil occurredOn is not an instant; use datePrecision.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

```json
{
  "name": "evidenceId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 200
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisEvidenceResultResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/onboarding/preparation

Read admitted facts for Insight onboarding

`get_insight_onboarding_preparation`

Private human-consented OAuth only; manual/root/system credentials and old frame-only Insight grants are refused. Requires insight:read in addition to this operation’s analysis scope. Never supply actor, organisation, sourcePolicy, grant or source families: the server admits the consenting person and attenuates sources before any source read. A result from a broader source view cannot be retrieved by filtering it. Current token, consent, native rights, frame and source dependencies are reread; inaccessible/stale evidence is not public. All analysis derivatives remain personal, including summaries based on private constraints. Recorded facts, interpretations and human proposals are distinct. Registration is not attendance. Unknown/partial sources are not zero. No autonomous CRM action, message, notification, webhook or export. GET is passive and never queues work or calls a model. Unknown fields are refused.

Returns at most six currently admitted factual observations to assist a human with framing. A confirmed minimum is not required. facts_only is neither a diagnosis nor a proposed personal intention: no model, queue, report or write is triggered. No draft constraints or declared intentions are passed to a model. Read declared common/personal answers separately with get_insight_context; never treat these observations as confirmed user answers. Source coverage, limits and current local/global population remain explicit.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private analysis result or immutable acceptance receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisPreparationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, missing scope/current consent, changed frame/source view, not found or unavailable owner. A possibly entered command returns INSIGHT_ANALYSIS_COMMAND_UNCERTAIN; preserve and replay the exact same intention and key rather than inventing another key.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAnalysisError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/feedback/actions/{actionId}

Read personal declarations for one server review action

`get_insight_action_feedback`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Reads the current feedback revision and declarations for this action. Old model advice titles, facts, bindings and source proofs are never returned. subject is null or a current canonically re-admitted contact/event/priority label; it never restores an old recommendation. Source removal or correction can make it null. Subject and comment admission are independent; a subject label may be available while the comment stays redacted. A comment is returned only after current source/presentation admission; otherwise comment=null and contentState=redacted. Revision and declaration metadata remain available without recovering deleted old evidence.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "actionId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 250
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackStateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/feedback/history

Read personal Insight declaration history

`list_insight_feedback_history`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Bounded live pagination by updatedAt descending, stable document ID ascending. Follow nextCursor unchanged; omit it for the first page. Updates during navigation can move rows: this is not a transaction snapshot. Source-inaccessible comments are redacted; subject is null or a currently re-admitted canonical contact/event/priority label, independent of comment availability. Historical metadata never grants access to old analysis advice. If the bounded response cannot fit, request a smaller limit.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1000
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackHistoryResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/feedback/done

Declare a server review action already done

`declare_insight_action_reviewed`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Use the server reviewAction.id/actionId and the exact resultId/topicId that presented it, not the free-form proposal text. The supported server actions are review_documented_need (review a documented need), review_event_fit (review event fit/preparation), reassess_priority (reassess the declared priority), review_recorded_exchange (review recorded contact exchanges), review_recorded_resources (review admitted recorded gross flows), review_calendar_preparation (review preparation around a community-calendar occasion), review_relationship_continuity (review the admitted recorded relationship history) and review_activity_history (review the admitted explicit-group activity comparison). A proposed call/message in model prose is not this review and cannot be declared completed through this endpoint. Read the action feedback revision first; use expectedRevision=0 only for an absent feedback document. Preserve operationKey (UUID), the exact payload and expectedRevision across retries. If the response is uncertain, replay the exact command or read its receipt; never invent another key. Conflict requires deliberate reconciliation.

Records only the human declaration that this precise server review/reassessment was done. It is not evidence that a proposed call/message occurred, not a completed interaction and not completion of all needs of a contact. Other declarations remain unchanged.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "resultId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "topicId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "resultId",
          "topicId",
          "actionId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/feedback/not-relevant

Declare a server review action not relevant personally

`mark_insight_action_not_relevant`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Use the server reviewAction.id/actionId and the exact resultId/topicId that presented it, not the free-form proposal text. The supported server actions are review_documented_need (review a documented need), review_event_fit (review event fit/preparation), reassess_priority (reassess the declared priority), review_recorded_exchange (review recorded contact exchanges), review_recorded_resources (review admitted recorded gross flows), review_calendar_preparation (review preparation around a community-calendar occasion), review_relationship_continuity (review the admitted recorded relationship history) and review_activity_history (review the admitted explicit-group activity comparison). A proposed call/message in model prose is not this review and cannot be declared completed through this endpoint. Read the action feedback revision first; use expectedRevision=0 only for an absent feedback document. Preserve operationKey (UUID), the exact payload and expectedRevision across retries. If the response is uncertain, replay the exact command or read its receipt; never invent another key. Conflict requires deliberate reconciliation.

Records a personal rejection with an optional private comment up to 2000 characters. The current relevant presentation must be admitted. This does not delete history or declare another action irrelevant.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "resultId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "topicId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "comment": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "resultId",
          "topicId",
          "actionId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/feedback/deferrals

Defer a server review action personally

`defer_insight_action_review`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Use the server reviewAction.id/actionId and the exact resultId/topicId that presented it, not the free-form proposal text. The supported server actions are review_documented_need (review a documented need), review_event_fit (review event fit/preparation), reassess_priority (reassess the declared priority), review_recorded_exchange (review recorded contact exchanges), review_recorded_resources (review admitted recorded gross flows), review_calendar_preparation (review preparation around a community-calendar occasion), review_relationship_continuity (review the admitted recorded relationship history) and review_activity_history (review the admitted explicit-group activity comparison). A proposed call/message in model prose is not this review and cannot be declared completed through this endpoint. Read the action feedback revision first; use expectedRevision=0 only for an absent feedback document. Preserve operationKey (UUID), the exact payload and expectedRevision across retries. If the response is uncertain, replay the exact command or read its receipt; never invent another key. Conflict requires deliberate reconciliation.

Provide dueOn (civil YYYY-MM-DD) and an explicit valid IANA timeZone. Deferral starts being reconsidered at the first instant of that local day, not its end. Choose a strictly future local day for a new declaration; the first instant must still be in the future at final admission before writing. An exact receipt can still be recovered after expiry. No CRM reminder is created and no old advice is automatically republished at expiry. A newly urgent fact can be evaluated independently without undoing this deferral.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_c7980fb3ed49b957c11a"
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/feedback/declarations/{declarationId}/undo

Undo exactly one personal Insight declaration

`undo_insight_feedback_declaration`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Use the server reviewAction.id/actionId and the exact resultId/topicId that presented it, not the free-form proposal text. The supported server actions are review_documented_need (review a documented need), review_event_fit (review event fit/preparation), reassess_priority (reassess the declared priority), review_recorded_exchange (review recorded contact exchanges), review_recorded_resources (review admitted recorded gross flows), review_calendar_preparation (review preparation around a community-calendar occasion), review_relationship_continuity (review the admitted recorded relationship history) and review_activity_history (review the admitted explicit-group activity comparison). A proposed call/message in model prose is not this review and cannot be declared completed through this endpoint. Read the action feedback revision first; use expectedRevision=0 only for an absent feedback document. Preserve operationKey (UUID), the exact payload and expectedRevision across retries. If the response is uncertain, replay the exact command or read its receipt; never invent another key. Conflict requires deliberate reconciliation.

Undoes only this declarationId under the current action feedback revision. Does not cancel another rejection/deferral or restore revoked source access. Current personal ownership and consent are required, but deleted/unreadable old evidence is not required. Returns metadata-only receipt; no archived title or citation is recovered. A fresh admitted analysis is required before advice can reappear.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:feedback:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "declarationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "actionId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:feedback:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/feedback/operations/{operationKey}

Recover an exact personal feedback receipt

`get_insight_feedback_operation`

Private human-consented OAuth only. Manual/root/system credentials and old grants without the requested scopes are refused, including for administrators. All operations require insight:read and insight:analyses:read; commands additionally require the new explicit insight:feedback:configure scope. Never supply actor, owner, organisation, sourcePolicy, grants or source families. Current token, consent, native ownership and source view are re-admitted before effects and private publication. All declarations belong only to the consenting person. No CRM action, suggestion pause/score, contact message, notification, webhook, model execution or calculation is performed by this operation. GET is passive. Unknown fields are refused.

Reads only this person’s exact operation receipt for actionId and the original UUID operationKey. No old source/presentation admission or source content is required. The receipt proves this intention, not a CRM action. Absence is not proof that an interrupted command cannot still finish.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:analyses:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

```json
{
  "name": "actionId",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 250
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified personal declaration metadata or exact operation receipt; no historical source content.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input, current consent/rights, presentation/revision conflict, missing declaration or unavailable owner error. INSIGHT_FEEDBACK_COMMAND_UNCERTAIN means the command may have entered: preserve the exact intention/key and recover its receipt.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightFeedbackError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:analyses:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 250000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/webhooks

Create a personal Insight webhook destination

`create_insight_webhook_destination`

Personal Insight destinations only: never the organisation wildcard webhook system. Every operation, including metadata reads, requires fresh explicit OAuth insight:webhooks:configure plus insight:read and insight:analyses:read. Manual/root/system keys and old grants without this scope are refused. No implicit analysis-request permission. Only this person and this OAuth application/resource may manage its destinations; another connection’s endpoints are inaccessible. ClientId, resource, sourceView and originRef are derived by the server, never accepted as arguments. URLs and signing secrets are sensitive write-only values; only endpointOrigin is readable. No destination operation creates an event, queues a delivery, sends a test request or performs inference. An active setting is configuration, not proof that delivery ports are qualified or that a message was sent. Current consent/rights are reread before effects and publication. Unknown fields are refused.

Preserve the exact UUID operationKey, expectedRevision and payload across retries. expectedRevision is the exact currently read revision. On uncertainty recover the original operation receipt or replay exactly the same command; never create another key automatically. A conflict requires deliberate reconciliation.

Explicit creation configures active=true; expectedRevision must be 0. Supply the HTTPS callback URL and a strong base64url signingSecret. The destination is bound to this exact current application/resource, consent origin and admitted source view. This creates configuration only: no event or network delivery is triggered. A qualified URL/vault/transport admission owner is mandatory; unavailable ports return 503.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_95afed61f212b9c25f46"
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified metadata or immutable receipt only; no URL path, query, signing secret, grant or source policy.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/webhooks

List this application’s personal Insight destinations

`list_insight_webhook_destinations`

Personal Insight destinations only: never the organisation wildcard webhook system. Every operation, including metadata reads, requires fresh explicit OAuth insight:webhooks:configure plus insight:read and insight:analyses:read. Manual/root/system keys and old grants without this scope are refused. No implicit analysis-request permission. Only this person and this OAuth application/resource may manage its destinations; another connection’s endpoints are inaccessible. ClientId, resource, sourceView and originRef are derived by the server, never accepted as arguments. URLs and signing secrets are sensitive write-only values; only endpointOrigin is readable. No destination operation creates an event, queues a delivery, sends a test request or performs inference. An active setting is configuration, not proof that delivery ports are qualified or that a message was sent. Current consent/rights are reread before effects and publication. Unknown fields are refused.

Live bounded metadata pagination, limit 1–50; follow nextCursor unchanged. Filters are server-bound to this actor, application and resource before reading rows. No destination from another connection is listed. Updates during navigation may move rows.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified metadata or immutable receipt only; no URL path, query, signing secret, grant or source policy.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/webhooks/{destinationId}

Read one personal Insight destination’s metadata

`get_insight_webhook_destination`

Personal Insight destinations only: never the organisation wildcard webhook system. Every operation, including metadata reads, requires fresh explicit OAuth insight:webhooks:configure plus insight:read and insight:analyses:read. Manual/root/system keys and old grants without this scope are refused. No implicit analysis-request permission. Only this person and this OAuth application/resource may manage its destinations; another connection’s endpoints are inaccessible. ClientId, resource, sourceView and originRef are derived by the server, never accepted as arguments. URLs and signing secrets are sensitive write-only values; only endpointOrigin is readable. No destination operation creates an event, queues a delivery, sends a test request or performs inference. An active setting is configuration, not proof that delivery ports are qualified or that a message was sent. Current consent/rights are reread before effects and publication. Unknown fields are refused.

The opaque destination ID never grants access. A current authorized management grant may read metadata for its same actor/application/resource after an old key or source view was revoked. This does not authorize delivery or recover its old secret or full callback URL.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified metadata or immutable receipt only; no URL path, query, signing secret, grant or source policy.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookDestinationResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/webhooks/{destinationId}

Update a personal Insight destination’s configuration

`update_insight_webhook_destination`

Personal Insight destinations only: never the organisation wildcard webhook system. Every operation, including metadata reads, requires fresh explicit OAuth insight:webhooks:configure plus insight:read and insight:analyses:read. Manual/root/system keys and old grants without this scope are refused. No implicit analysis-request permission. Only this person and this OAuth application/resource may manage its destinations; another connection’s endpoints are inaccessible. ClientId, resource, sourceView and originRef are derived by the server, never accepted as arguments. URLs and signing secrets are sensitive write-only values; only endpointOrigin is readable. No destination operation creates an event, queues a delivery, sends a test request or performs inference. An active setting is configuration, not proof that delivery ports are qualified or that a message was sent. Current consent/rights are reread before effects and publication. Unknown fields are refused.

Preserve the exact UUID operationKey, expectedRevision and payload across retries. expectedRevision is the exact currently read revision. On uncertainty recover the original operation receipt or replay exactly the same command; never create another key automatically. A conflict requires deliberate reconciliation.

Modifier au moins un champ parmi url, signingSecret, active ou eventTypes ; les omissions conservent les valeurs. Identity, consent origin and source-view binding are not caller-editable. Management under a new grant does not reauthorize delivery bound to a revoked origin/source view. active=true only changes configuration; it sends nothing.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_3e0880e63a0e8aadb9d7"
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified metadata or immutable receipt only; no URL path, query, signing secret, grant or source policy.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## POST /insight/webhooks/{destinationId}/disable

Disable one personal Insight destination

`disable_insight_webhook_destination`

Personal Insight destinations only: never the organisation wildcard webhook system. Every operation, including metadata reads, requires fresh explicit OAuth insight:webhooks:configure plus insight:read and insight:analyses:read. Manual/root/system keys and old grants without this scope are refused. No implicit analysis-request permission. Only this person and this OAuth application/resource may manage its destinations; another connection’s endpoints are inaccessible. ClientId, resource, sourceView and originRef are derived by the server, never accepted as arguments. URLs and signing secrets are sensitive write-only values; only endpointOrigin is readable. No destination operation creates an event, queues a delivery, sends a test request or performs inference. An active setting is configuration, not proof that delivery ports are qualified or that a message was sent. Current consent/rights are reread before effects and publication. Unknown fields are refused.

Preserve the exact UUID operationKey, expectedRevision and payload across retries. expectedRevision is the exact currently read revision. On uncertainty recover the original operation receipt or replay exactly the same command; never create another key automatically. A conflict requires deliberate reconciliation.

Sets this destination inactive under the expected revision. Current authorized management remains possible when the original delivery grant or source view was revoked. Does not delete another destination or reauthorize any delivery.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified metadata or immutable receipt only; no URL path, query, signing secret, grant or source policy.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/webhooks/{destinationId}/operations/{operationKey}

Recover an exact personal destination operation receipt

`get_insight_webhook_operation`

Personal Insight destinations only: never the organisation wildcard webhook system. Every operation, including metadata reads, requires fresh explicit OAuth insight:webhooks:configure plus insight:read and insight:analyses:read. Manual/root/system keys and old grants without this scope are refused. No implicit analysis-request permission. Only this person and this OAuth application/resource may manage its destinations; another connection’s endpoints are inaccessible. ClientId, resource, sourceView and originRef are derived by the server, never accepted as arguments. URLs and signing secrets are sensitive write-only values; only endpointOrigin is readable. No destination operation creates an event, queues a delivery, sends a test request or performs inference. An active setting is configuration, not proof that delivery ports are qualified or that a message was sent. Current consent/rights are reread before effects and publication. Unknown fields are refused.

Reads this actor/application/resource’s exact receipt for the original UUID operationKey. Receipt contains no URL or secret. Not found is not proof that an interrupted command cannot still finish. Current management consent is required, but old delivery source admission is not recovered.

Extension I5 : eventTypes est un choix fermé explicite. Une ancienne ligne et une création omise restent insight.analysis.ready uniquement ; une omission en modification conserve le choix. Ajouter insight.weekly.ready exige insight:weekly:read courant en plus des droits de gestion. Retirer ce type ou désactiver reste possible sous les droits de gestion actuels. L’origine et le périmètre de remise ne sont jamais renouvelés par cette modification ; si l’origine ancienne n’a plus les droits requis, créer une nouvelle destination admissible pour rétablir une remise. Le payload hebdomadaire ne contient que eventId/kind/time/reportId/reportVersion/occurrenceId/link relatif exact, sans texte de bilan. kind=weekly.ready ; le type d’abonnement est insight.weekly.ready. Les deux kinds historiques analysis.ready/analysis.updated gardent leur contrat sous insight.analysis.ready. Aucune requête GET ne publie ou livre.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:webhooks:configure",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "destinationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified metadata or immutable receipt only; no URL path, query, signing secret, grant or source policy.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic refused input, current consent/ownership, revision conflict, not found or unavailable qualified ports. INSIGHT_WEBHOOK_COMMAND_UNCERTAIN may follow entry: preserve the exact command and recover its receipt. Secrets and URL paths/query never appear in errors.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWebhookError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:webhooks:configure",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/preferences

Read personal weekly-report preferences

`get_insight_weekly_preferences`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

No default weekday, time, zone or language is invented. schedule and language may be null. emailEnabled and availabilityNoticeEnabled are separate and default off; configuring a schedule never activates either. A stored true choice does not mean delivery is currently available.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:read",
  "additional": [
    "insight:read"
  ]
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPreferencesResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/weekly/preferences

Save personal weekly-report preferences

`update_insight_weekly_preferences`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Provide a UUID operationKey and exact expectedRevision read from preferences (0 if absent), plus at least one patch field. Omitted fields are preserved. schedule is replaced as a complete weekday/localTime/timeZone tuple or null; it never patches one tuple field. language uses fr/en/he/de/es/gr/ro or null. Explicit preferences consent also permits storing the two independent opt-ins; neither sends anything in I4. Preserve the exact payload/key/revision for receipt recovery by replay; receipt GET separately needs weekly:read.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:preferences:configure",
  "additional": [
    "insight:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_225b2a9e388335330940"
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPreferencesReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:preferences:configure",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/weekly/preferences/operations/{operationKey}

Recover an exact weekly-preference receipt

`get_insight_weekly_preferences_operation`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Reads only the consenting user’s immutable exact receipt. It proves acquisition of that preference intention, not an email, notice or current unchanged preference values. Missing receipt is not proof that an interrupted save cannot finish.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPreferencesReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/weekly/reports

Request an exact personal weekly occurrence

`request_insight_weekly_report`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Read get_insight_weekly_status first and use its server occurrenceId and preferenceRevision. Never compose an occurrence ID from an assumed date. Supply a UUID operationKey and expectedPreferenceRevision. This acquires queued preparation, not a ready report. Explicit requests may prepare before T−30; publication waits the scheduled instant. Same intention/key recovers the immutable receipt even if preferences later change. Preserve exact payload on uncertainty. weekly:request plus insight:read permits exact replay without weekly:read; receipt GET and report reads separately require weekly:read. No email/notice is sent.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:request",
  "additional": [
    "insight:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedPreferenceRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "occurrenceId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "operationKey",
          "expectedPreferenceRevision",
          "occurrenceId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:request",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/weekly/reports

List admitted weekly-report version metadata

`list_insight_weekly_reports`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Bounded live pagination, maximum 20 versions, exact source view and owner. Follow nextCursor unchanged; it is not a transaction snapshot. Metadata is not permission to restore old analysis advice or read another version. No report preparation or backfill runs.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 20
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1500
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/status

Read the next or selected weekly-report occurrence

`get_insight_weekly_status`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Omit occurrenceId to read the next theoretical server slot, or pass an exact advertised occurrenceId to inspect acquired work. Incomplete schedule/language/calendar stays explicit. scheduled/queued/running/budget_waiting/prepared is not ready. Period is persisted civil [from,to), not a fabricated 168-hour week. DST gaps are skipped; overlaps select one qualified instant. This GET never acquires preparation or changes the calendar.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "occurrenceId",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyStatusResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/reports/{reportId}/versions/{reportVersion}

Read one exact historical weekly-report version

`get_insight_weekly_report`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Select the exact reportId and reportVersion, never the latest by substitution. An old frame is a dated declaration, not today’s framing. Current source proofs/view and ownership remain required; source correction/revocation yields unavailable with result/frame null, not old advice. comparison unavailable and partial coverage are explicit; appeared_in_admitted_data and declared_priority_changed do not mean human or financial progress. At most three changes and three attentions; no required card count.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "reportId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

```json
{
  "name": "reportVersion",
  "in": "path",
  "required": true,
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 9007199254740990
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyReportResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/operations/{operationKey}

Recover an exact weekly-report request receipt

`get_insight_weekly_operation`

Private human-consented OAuth only, with insight:read and this operation’s new explicit weekly scope. Old frame/analysis/feedback grants, manual/root/system credentials and another owner’s content are refused. Weekly read/request and preferences configuration are separate grants; analysis-request permission is never inferred. Source families are attenuated by the server before reading and must remain currently admitted. Never supply actor, organisation, sourcePolicy, proof, capsule or a source selector. GET is passive: no job, model, renderer, renewal or delivery. I4 stores independent email/availability-notice choices but creates no dispatchable email, notification, SMTP or push; I5 delivery is not active. Unknown fields are refused.

Uses the original UUID, current personal consent and exact current source view. queued remains the immutable acceptance status even after report publication. Receipt is not proof of email, PDF or current source availability; read the exact report/status separately.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:weekly:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified private owner result or immutable operation receipt; no raw proofs/capsule/authority.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic input/current consent/current source admission/revision conflict/not found/unavailable error. A command possibly entered returns INSIGHT_WEEKLY_COMMAND_UNCERTAIN; recover or replay the exact original intention/key rather than inventing another UUID.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:weekly:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/weekly/documents

Prepare a shareable PDF of one exact weekly report version

`prepare_insight_weekly_document`

Personal OAuth with insight:read and the explicit document scope of this operation. Old weekly/analysis/frame grants do not automatically permit document preparation, sharing or reading. Document-only consent needs no implicit weekly:read or analysis-request scope. Exact source view, actor and original report-version proofs are re-admitted. Never supply actor, organisation, sourcePolicy, capsule, raw frame, proof, HTML or a public URL. Only projection=shareable is allowed. The independently prepared shareable lineage omits private constraints/enrichment/comments and personal analysis prose; essential omissions and partial coverage remain visible. Never silently replace an unavailable analytical projection with factual-only content. This is preparation/private retrieval, not email, upload, notification or a native-device share action. Copies shared manually are dated and cannot be remotely revoked. Unknown fields are refused.

Provide a UUID operationKey plus the exact reportId, reportVersion and projection=shareable. This acquires queued work, not a ready PDF; no renderer runs in this HTTP command. Preserve the same UUID and exact payload after uncertainty; replay recovers its immutable receipt without a second render. A prepare grant permits exact replay without the separate documents:read scope. Neither subscription nor human sharing is activated.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:documents:prepare",
  "additional": [
    "insight:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "projection": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          }
        },
        "required": [
          "operationKey",
          "reportId",
          "reportVersion",
          "projection"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified exact private document result; no raw capsule/source proof or public download URL.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:prepare",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/weekly/documents/{documentId}/status

Read an existing weekly PDF preparation state

`get_insight_weekly_document_status`

Personal OAuth with insight:read and the explicit document scope of this operation. Old weekly/analysis/frame grants do not automatically permit document preparation, sharing or reading. Document-only consent needs no implicit weekly:read or analysis-request scope. Exact source view, actor and original report-version proofs are re-admitted. Never supply actor, organisation, sourcePolicy, capsule, raw frame, proof, HTML or a public URL. Only projection=shareable is allowed. The independently prepared shareable lineage omits private constraints/enrichment/comments and personal analysis prose; essential omissions and partial coverage remain visible. Never silently replace an unavailable analytical projection with factual-only content. This is preparation/private retrieval, not email, upload, notification or a native-device share action. Copies shared manually are dated and cannot be remotely revoked. Unknown fields are refused.

Passive queued/running/ready/refused/failed state and digests. queued/running is not a file ready to share. Missing glyphs, layout, Chromium or current source admission can refuse preparation; never fabricate an empty successful PDF.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:documents:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified exact private document result; no raw capsule/source proof or public download URL.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfMetadataResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/{documentId}/preview

Preview the exact shareable weekly PDF content

`get_insight_weekly_document_preview`

Personal OAuth with insight:read and the explicit document scope of this operation. Old weekly/analysis/frame grants do not automatically permit document preparation, sharing or reading. Document-only consent needs no implicit weekly:read or analysis-request scope. Exact source view, actor and original report-version proofs are re-admitted. Never supply actor, organisation, sourcePolicy, capsule, raw frame, proof, HTML or a public URL. Only projection=shareable is allowed. The independently prepared shareable lineage omits private constraints/enrichment/comments and personal analysis prose; essential omissions and partial coverage remain visible. Never silently replace an unavailable analytical projection with factual-only content. This is preparation/private retrieval, not email, upload, notification or a native-device share action. Copies shared manually are dated and cannot be remotely revoked. Unknown fields are refused.

Returns the exact stored admitted projection content, its contentDigest, omissions and coverage; never personal-result prose or PDF bytes. Review this exact report/version/projection before manual share. A queued document may already have an exact preview, but its bytes are not ready. A source change can refuse both preview and later content retrieval.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:documents:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified exact private document result; no raw capsule/source proof or public download URL.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfPreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/{documentId}

Read exact weekly PDF metadata

`get_insight_weekly_document_metadata`

Personal OAuth with insight:read and the explicit document scope of this operation. Old weekly/analysis/frame grants do not automatically permit document preparation, sharing or reading. Document-only consent needs no implicit weekly:read or analysis-request scope. Exact source view, actor and original report-version proofs are re-admitted. Never supply actor, organisation, sourcePolicy, capsule, raw frame, proof, HTML or a public URL. Only projection=shareable is allowed. The independently prepared shareable lineage omits private constraints/enrichment/comments and personal analysis prose; essential omissions and partial coverage remain visible. Never silently replace an unavailable analytical projection with factual-only content. This is preparation/private retrieval, not email, upload, notification or a native-device share action. Copies shared manually are dated and cannot be remotely revoked. Unknown fields are refused.

Existing metadata/digests only, without generating, refreshing, extending expiry or returning bytes. contentDigest identifies the exact preview content; sha256 identifies decoded PDF bytes and is a different value.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:documents:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified exact private document result; no raw capsule/source proof or public download URL.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfMetadataResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/{documentId}/content

Read bounded existing private weekly PDF bytes

`get_insight_weekly_document_content`

Personal OAuth with insight:read and the explicit document scope of this operation. Old weekly/analysis/frame grants do not automatically permit document preparation, sharing or reading. Document-only consent needs no implicit weekly:read or analysis-request scope. Exact source view, actor and original report-version proofs are re-admitted. Never supply actor, organisation, sourcePolicy, capsule, raw frame, proof, HTML or a public URL. Only projection=shareable is allowed. The independently prepared shareable lineage omits private constraints/enrichment/comments and personal analysis prose; essential omissions and partial coverage remain visible. Never silently replace an unavailable analytical projection with factual-only content. This is preparation/private retrieval, not email, upload, notification or a native-device share action. Copies shared manually are dated and cannot be remotely revoked. Unknown fields are refused.

Returns only an already ready PDF, at most 4 MiB decoded, as private JSON contentBase64 plus MIME, filename, bytes and SHA-256. Decode base64 and verify SHA-256 over decoded PDF bytes, not the base64 string. No ASSETS/public URL, data URI, bearer link or server fetch is returned or invented. This passive GET never renders or retries a failed preparation. A downloaded/shared copy is dated and cannot be revoked remotely.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:documents:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "documentId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified exact private document result; no raw capsule/source proof or public download URL.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfContentResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/weekly/documents/operations/{operationKey}

Recover an exact weekly PDF preparation receipt

`get_insight_weekly_document_operation`

Personal OAuth with insight:read and the explicit document scope of this operation. Old weekly/analysis/frame grants do not automatically permit document preparation, sharing or reading. Document-only consent needs no implicit weekly:read or analysis-request scope. Exact source view, actor and original report-version proofs are re-admitted. Never supply actor, organisation, sourcePolicy, capsule, raw frame, proof, HTML or a public URL. Only projection=shareable is allowed. The independently prepared shareable lineage omits private constraints/enrichment/comments and personal analysis prose; essential omissions and partial coverage remain visible. Never silently replace an unavailable analytical projection with factual-only content. This is preparation/private retrieval, not email, upload, notification or a native-device share action. Copies shared manually are dated and cannot be remotely revoked. Unknown fields are refused.

Original operationKey plus current personal documents:read consent. Receipt binds documentId to the exact report/version/shareable projection; it is not proof of ready bytes or human sharing. An absent receipt does not prove an interrupted prepare cannot still finish.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:documents:read",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Qualified exact private document result; no raw capsule/source proof or public download URL.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Generic closed input/current consent/source admission/conflict/not found/size or unavailable renderer error. After possible command entry, INSIGHT_WEEKLY_PDF_COMMAND_UNCERTAIN requires exact original UUID/payload replay or receipt recovery.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightWeeklyPdfError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:documents:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 8388608
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/notifications/preferences

Lire les préférences personnelles de diffusion

`get_insight_notification_preferences`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Les alertes ponctuelles sont désactivées par défaut. nightEnabled null signifie choix de silence quotidien inconnu, pas autorisation de livrer. Une configuration incomplète retient la diffusion concernée sans bloquer les analyses. Le lieu est une ville déclarée confirmée, jamais une preuve GPS. Les opt-ins email/avis hebdomadaires restent dans les préférences hebdomadaires distinctes.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:notifications:read",
  "additional": [
    "insight:read"
  ]
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsPreferencesResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /insight/notifications/preferences

Configurer les préférences personnelles de diffusion

`update_insight_notification_preferences`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Fournir UUID operationKey, expectedRevision exacte et au moins un champ. Omission conservée ; quietHours et location sont des tuples complets ou null. Les heures identiques sont refusées. Fuseau IANA explicite ; aucun repli Paris ni ville déduite ou confirmation automatique. Le client humain confirme la ville ; une IA ne doit pas inventer cette confirmation. Aucune capture, inscription de token ni remise immédiate. Après incertitude, rejouer exactement la même intention/clé/révision ; le reçu se lit avec le même scope configure, sans read supplémentaire.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:notifications:configure",
  "additional": [
    "insight:read"
  ]
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_e507089f51f89fe39e78"
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:configure",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /insight/notifications/preferences/operations/{operationKey}

Récupérer le reçu exact des préférences de diffusion

`get_insight_notification_preferences_operation`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Fournir la UUID originale ; notifications:configure est requis comme pour la commande. Le reçu prouve la sauvegarde de cette intention, jamais un envoi ni la configuration courante. Son absence ne prouve pas qu’une sauvegarde interrompue ne terminera pas.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:notifications:configure",
  "additional": [
    "insight:read"
  ]
}
```

### Parameters

```json
{
  "name": "operationKey",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsReceiptResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:configure",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/notifications/status

Lire l’état personnel des canaux et silences

`get_insight_notification_status`

OAuth personnel explicitement consenti, propriétaire courant uniquement, avec insight:read et le scope de cette opération. Les anciens grants, clés manuelles/root/système et données d’autrui sont refusés, même pour un ADMIN. Ne fournir ni acteur, organisation, destinataire, email, token d’appareil, preuve, sourcePolicy ni identité privée. Les champs inconnus sont refusés. GET passif : aucun calcul, acquisition, inscription d’appareil, rendu ou envoi. Trois familles distinctes : alerte ponctuelle, avis hebdomadaire et email hebdomadaire. enabled décrit la disponibilité technique, optedIn le choix métier. allowed n’est pas une preuve d’envoi ; deferred/unknown/refused/disabled restent distincts. Counts accepted indique une acceptation fournisseur, pas une remise ou lecture humaine ; awaiting_email n’est pas une acceptation SMTP et uncertain interdit un renvoi automatique. Aucun token, email brut, quota intercompte ou identité privée n’est exposé.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:notifications:read",
  "additional": [
    "insight:read"
  ]
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Résultat personnel admis ou reçu immuable exact, sans identité de diffusion privée.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsStatusResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique de validation, droit courant, conflit, absence ou indisponibilité. Une mutation potentiellement commencée retourne INSIGHT_NOTIFICATIONS_COMMAND_UNCERTAIN : conserver clé et charge exactes, sans nouvelle UUID automatique.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightNotificationsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:notifications:read",
  "x-unisoft-additional-scopes": [
    "insight:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 10000,
    "maxBytes": 1048576
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/alerts

Lister les alertes personnelles déjà préparées

`list_insight_alerts`

OAuth personnel explicite avec insight:alerts:read, insight:analyses:read et insight:read ; propriétaire et toutes les sources de la vue couramment admis. Les grants antérieurs, ADMIN d’autrui et clés manuelles/root/système sont refusés. Ne fournir ni acteur, organisation, sources, preuve ni destinataire. GET passif : aucune capture, inférence, file, relance ou remise. Pagination vivante bornée à 20 ; conserver nextCursor sans modification. Les métadonnées ne réautorisent aucun ancien sujet. admission unavailable conserve uniquement des métadonnées et subjectCount null. deliveryStatus accepted signifie acceptation fournisseur, pas réception ou lecture ; uncertain ne justifie pas un renvoi automatique. Aucun total exhaustif ni instantané transactionnel.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:alerts:read",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 20
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 1500
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Alerte personnelle réadmise ou indisponibilité explicite sans ancien contenu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsListResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:alerts:read",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /insight/alerts/{alertId}

Lire une alerte personnelle actuellement réadmise

`get_insight_alert`

OAuth personnel explicite avec insight:alerts:read, insight:analyses:read et insight:read ; propriétaire et toutes les sources de la vue couramment admis. Les grants antérieurs, ADMIN d’autrui et clés manuelles/root/système sont refusés. Ne fournir ni acteur, organisation, sources, preuve ni destinataire. GET passif : aucune capture, inférence, file, relance ou remise. Sélectionner l’identifiant exact annoncé. unavailable retourne subjects vide, sans ancien texte/proposition. Chaque sujet prêt contient son petit registre evidence : les evidenceIds du sujet, du motif et du delta se résolvent dans ce registre d’alerte, sans faux resultId I2 ni lecture arbitraire de collection. Les faits sont datés ; une suggestion reste une proposition. L’événement avant le prochain bilan motive un réexamen, pas une préparation manquante. Une alerte deferred_new_deadline conserve le report actif ; elle ne remet pas sa carte dans Situation actuelle et n’annule aucune déclaration.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "insight:alerts:read",
  "additional": [
    "insight:read",
    "insight:analyses:read"
  ]
}
```

### Parameters

```json
{
  "name": "alertId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[a-f0-9]{64}$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Alerte personnelle réadmise ou indisponibilité explicite sans ancien contenu.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Erreur générique sans requête, preuve, identité privée ni réponse fournisseur brute.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/InsightAlertsError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "insight:alerts:read",
  "x-unisoft-additional-scopes": [
    "insight:read",
    "insight:analyses:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp-output-limits": {
    "maxNodes": 100000,
    "maxBytes": 16777216
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schemas

```json
{
  "components": {
    "schemas": {
      "InsightContextResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightContext"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "common": {
            "$ref": "#/components/schemas/InsightCommonContext"
          },
          "personal": {
            "$ref": "#/components/schemas/InsightPersonalContext"
          },
          "permissions": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "canEditCommon": {
                "type": "boolean"
              }
            },
            "required": [
              "canEditCommon"
            ]
          },
          "onboarding": {
            "$ref": "#/components/schemas/InsightOnboarding"
          }
        },
        "required": [
          "common",
          "personal",
          "permissions",
          "onboarding"
        ]
      },
      "InsightCommonContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "mission": {
            "type": "string",
            "maxLength": 8000
          },
          "context": {
            "type": "string",
            "maxLength": 16000
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "updatedBy": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "nullable": true
          }
        },
        "required": [
          "revision",
          "mission",
          "context",
          "updatedAt",
          "updatedBy"
        ]
      },
      "InsightPersonalContext": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "audience": {
            "type": "string",
            "maxLength": 8000
          },
          "primaryPriority": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "text": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1
              },
              "dueOn": {
                "type": "string",
                "format": "date",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              }
            },
            "required": [
              "id",
              "text",
              "dueOn"
            ],
            "nullable": true
          },
          "secondaryPriorities": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1
                },
                "text": {
                  "type": "string",
                  "maxLength": 4000,
                  "minLength": 1
                },
                "dueOn": {
                  "type": "string",
                  "format": "date",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "nullable": true
                }
              },
              "required": [
                "id",
                "text",
                "dueOn"
              ]
            }
          },
          "population": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ]
          },
          "constraints": {
            "type": "string",
            "maxLength": 16000
          },
          "enrichment": {
            "type": "string",
            "maxLength": 16000
          },
          "confirmation": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "commonRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "personalRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "confirmedAt": {
                "type": "string",
                "format": "date-time"
              },
              "minimum": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "mission": {
                    "type": "string",
                    "maxLength": 8000
                  },
                  "audience": {
                    "type": "string",
                    "maxLength": 8000
                  },
                  "primaryPriority": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "type": "string",
                        "maxLength": 100,
                        "minLength": 1
                      },
                      "text": {
                        "type": "string",
                        "maxLength": 4000,
                        "minLength": 1
                      },
                      "dueOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      }
                    },
                    "required": [
                      "id",
                      "text",
                      "dueOn"
                    ]
                  },
                  "population": {
                    "type": "string",
                    "enum": [
                      "local",
                      "global"
                    ]
                  }
                },
                "required": [
                  "mission",
                  "audience",
                  "primaryPriority",
                  "population"
                ]
              }
            },
            "required": [
              "commonRevision",
              "personalRevision",
              "confirmedAt",
              "minimum"
            ],
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "revision",
          "audience",
          "primaryPriority",
          "secondaryPriorities",
          "population",
          "constraints",
          "enrichment",
          "confirmation",
          "updatedAt"
        ]
      },
      "InsightOnboarding": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "minimum": {
            "type": "string",
            "enum": [
              "not_started",
              "draft",
              "confirmed"
            ]
          },
          "missing": {
            "type": "array",
            "maxItems": 3,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "mission",
                "audience",
                "primaryPriority"
              ]
            }
          },
          "optional": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "constraints": {
                "type": "boolean"
              },
              "enrichment": {
                "type": "boolean"
              }
            },
            "required": [
              "constraints",
              "enrichment"
            ]
          },
          "commonChangedSinceConfirmation": {
            "type": "boolean"
          },
          "activation": {
            "type": "string",
            "enum": [
              "awaiting_initial_report"
            ]
          }
        },
        "required": [
          "minimum",
          "missing",
          "optional",
          "commonChangedSinceConfirmation",
          "activation"
        ]
      },
      "InsightError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "saveCommon",
              "savePersonal",
              "confirmOnboarding"
            ]
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          }
        },
        "required": [
          "action",
          "expectedRevision",
          "appliedRevision",
          "appliedAt",
          "operationKey"
        ]
      },
      "UnisoftRequest_86acc4db603dce0726a0": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "audience": {
            "type": "string",
            "maxLength": 8000
          },
          "primaryPriority": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 4000
              },
              "dueOn": {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "format": "date",
                "nullable": true
              }
            },
            "required": [
              "id",
              "text",
              "dueOn"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "secondaryPriorities": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "text": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4000
                },
                "dueOn": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "format": "date",
                  "nullable": true
                }
              },
              "required": [
                "id",
                "text",
                "dueOn"
              ],
              "additionalProperties": false
            }
          },
          "population": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ]
          },
          "constraints": {
            "type": "string",
            "maxLength": 16000
          },
          "enrichment": {
            "type": "string",
            "maxLength": 16000
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "audience"
            ]
          },
          {
            "required": [
              "primaryPriority"
            ]
          },
          {
            "required": [
              "secondaryPriorities"
            ]
          },
          {
            "required": [
              "population"
            ]
          },
          {
            "required": [
              "constraints"
            ]
          },
          {
            "required": [
              "enrichment"
            ]
          }
        ]
      },
      "InsightOnboardingResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightOnboarding"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued"
            ]
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro"
            ],
            "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
          },
          "frameRevision": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "common": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "personal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "common",
              "personal"
            ]
          }
        },
        "required": [
          "id",
          "operationKey",
          "acceptedAt",
          "status",
          "language",
          "frameRevision"
        ]
      },
      "InsightAnalysisError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightAnalysisStateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisState"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "missing",
              "pending",
              "queued",
              "running",
              "ready",
              "failed",
              "stale"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "receipt": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "operationKey": {
                "type": "string",
                "format": "uuid",
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
              },
              "acceptedAt": {
                "type": "string",
                "format": "date-time"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              }
            },
            "required": [
              "id",
              "operationKey",
              "acceptedAt",
              "status",
              "language",
              "frameRevision"
            ],
            "nullable": true
          },
          "result": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "ready"
                ]
              },
              "generatedAt": {
                "type": "string",
                "format": "date-time"
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              },
              "summary": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2400
                  },
                  "evidenceIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "maxItems": 100,
                    "uniqueItems": true
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "facts_only",
                      "admitted_topics"
                    ]
                  }
                },
                "required": [
                  "text",
                  "evidenceIds"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 250
                    },
                    "family": {
                      "type": "string",
                      "enum": [
                        "documented_attention",
                        "event_opportunity",
                        "priority_review",
                        "recorded_relationship",
                        "recorded_resources",
                        "calendar_preparation",
                        "relationship_continuity",
                        "activity_history"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "human_review"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "text",
                        "kind",
                        "targetId"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "priorityIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "caveats": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    },
                    "reviewAction": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "review_documented_need",
                            "review_event_fit",
                            "reassess_priority",
                            "review_recorded_exchange",
                            "review_recorded_resources",
                            "review_calendar_preparation",
                            "review_relationship_continuity",
                            "review_activity_history"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "type",
                        "targetId"
                      ]
                    },
                    "reappearance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 800
                        },
                        "evidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "maxItems": 100,
                          "uniqueItems": true
                        }
                      },
                      "required": [
                        "text",
                        "evidenceIds"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "family",
                    "title",
                    "conclusion",
                    "reason",
                    "proposal",
                    "evidenceIds",
                    "priorityIds",
                    "caveats"
                  ]
                },
                "maxItems": 5
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "nature": {
                      "type": "string",
                      "enum": [
                        "declared",
                        "recorded_fact",
                        "prepared_suggestion"
                      ]
                    },
                    "source": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ],
                      "nullable": true
                    },
                    "contactId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "nullable": true
                    },
                    "observedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "occurredAt": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "occurredOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    },
                    "datePrecision": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "labelCode": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "text": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 16000
                    },
                    "facts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$",
                            "description": "Typed admitted fact. contact_marked_local is true/false/null for the current contact marking, not physical location. registration_count counts admitted registered contacts, not families or attendance. Coverage is not preparation progress. DEV extended source facts: recorded_interaction is a dated CRM trace, not an unfulfilled need. recorded_resources use separate currencies and two completed 30-day UTC periods excluding today; monetary fact unit minor:CODE:EXP means divide by 10^EXP. Null totals mean unqualified or excluded records, never zero. They are gross recorded payments, not available cash, donations only, bank settlement or project budget. community_calendar is a calculated civil occasion, not personal free/busy or missing preparation. DEV longitudinal relationship_history and activity_history require contacts, events and registrations together. firstVisibleRegistrationAt is the first visible validated registration inside the 180-day window, not the first-ever relationship. laterRecordedInteractionCount counts strictly later instant-level records; day precision cannot prove ordering. Activity periods are two complete 90-day UTC windows, classified by recorded event start, not registration creation. Distinct contacts, contact-event pairs and per-event averages are different units. comparisonAvailable=false prohibits a trend comparison. Synthetic insight_relationship_history and insight_activity_history source IDs are opaque projections, not event IDs. Window from/splitAt/to are half-open UTC boundaries; the end is excluded. Same explicit group does not prove identical format, audience, attendance, loyalty or causal effectiveness. Archived valid registrations are included as currently recorded; no immutable historical snapshot is implied. Exchange-only continuity is also supported: firstVisibleInteractionAt/lastVisibleInteractionAt and laterRecordedExchangeCount use the first visible instant-level exchange as their reference. laterRecordedInteractionCount remains relative to the first visible registration, and is null without one. firstEverContactAt/firstEverRegistrationAt remain unknown. registrationChronologyKnown=false withholds registration metrics without inventing zero or discarding qualified dated exchanges."
                          },
                          "value": {
                            "oneOf": [
                              {
                                "type": "string",
                                "maxLength": 16000
                              },
                              {
                                "type": "number"
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "string",
                                "nullable": true,
                                "enum": [
                                  null
                                ]
                              }
                            ]
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "nullable": true
                          }
                        },
                        "required": [
                          "code",
                          "value",
                          "unit"
                        ]
                      },
                      "maxItems": 100
                    },
                    "references": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "collection": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "contactId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "nullable": true
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 10000,
                            "nullable": true
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                          },
                          "occurredOn": {
                            "type": "string",
                            "format": "date",
                            "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                            "nullable": true
                          },
                          "datePrecision": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          }
                        },
                        "required": [
                          "collection",
                          "id",
                          "contactId",
                          "quote",
                          "at",
                          "occurredOn",
                          "datePrecision"
                        ]
                      },
                      "maxItems": 100
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "id",
                    "nature",
                    "source",
                    "contactId",
                    "observedAt",
                    "occurredAt",
                    "occurredOn",
                    "datePrecision",
                    "labelCode",
                    "text",
                    "facts",
                    "references",
                    "limits"
                  ]
                },
                "maxItems": 120
              },
              "clarifications": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    }
                  },
                  "required": [
                    "text"
                  ]
                },
                "maxItems": 1
              },
              "coverage": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "partial",
                      "unknown"
                    ]
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "family": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "unavailable",
                            "forbidden",
                            "unknown"
                          ]
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "nullable": true
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "family",
                        "status",
                        "count",
                        "limits"
                      ]
                    },
                    "maxItems": 30
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  },
                  "localDate": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  },
                  "calendarReview": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  }
                },
                "required": [
                  "status",
                  "sources",
                  "limits",
                  "localDate",
                  "calendarReview"
                ]
              },
              "privacy": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "classification": {
                    "type": "string",
                    "enum": [
                      "personal"
                    ]
                  },
                  "privateDependencies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "personal_frame",
                        "constraints",
                        "enrichment"
                      ]
                    },
                    "maxItems": 3,
                    "uniqueItems": true
                  }
                },
                "required": [
                  "classification",
                  "privateDependencies"
                ]
              }
            },
            "required": [
              "version",
              "status",
              "generatedAt",
              "language",
              "frameRevision",
              "summary",
              "topics",
              "evidence",
              "clarifications",
              "coverage",
              "privacy"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_ANALYSIS_FAILED"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          },
          "waitReason": {
            "type": "string",
            "enum": [
              "structured_inference_budget"
            ]
          },
          "retryAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "status",
          "id",
          "receipt",
          "result",
          "error"
        ]
      },
      "InsightAnalysisTopicsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisTopics"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisTopics": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "missing",
              "pending",
              "queued",
              "running",
              "ready",
              "failed",
              "stale"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "receipt": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "operationKey": {
                "type": "string",
                "format": "uuid",
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
              },
              "acceptedAt": {
                "type": "string",
                "format": "date-time"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              }
            },
            "required": [
              "id",
              "operationKey",
              "acceptedAt",
              "status",
              "language",
              "frameRevision"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_ANALYSIS_FAILED"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 250
                },
                "family": {
                  "type": "string",
                  "enum": [
                    "documented_attention",
                    "event_opportunity",
                    "priority_review",
                    "recorded_relationship",
                    "recorded_resources",
                    "calendar_preparation",
                    "relationship_continuity",
                    "activity_history"
                  ]
                },
                "title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "conclusion": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "reason": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                },
                "proposal": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "human_review"
                      ]
                    },
                    "targetId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "required": [
                    "text",
                    "kind",
                    "targetId"
                  ]
                },
                "evidenceIds": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "maxItems": 100,
                  "uniqueItems": true
                },
                "priorityIds": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "maxItems": 100,
                  "uniqueItems": true
                },
                "caveats": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  },
                  "maxItems": 100
                },
                "reviewAction": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "review_documented_need",
                        "review_event_fit",
                        "reassess_priority",
                        "review_recorded_exchange",
                        "review_recorded_resources",
                        "review_calendar_preparation",
                        "review_relationship_continuity",
                        "review_activity_history"
                      ]
                    },
                    "targetId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "targetId"
                  ]
                },
                "reappearance": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 800
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    }
                  },
                  "required": [
                    "text",
                    "evidenceIds"
                  ],
                  "nullable": true
                }
              },
              "required": [
                "id",
                "family",
                "title",
                "conclusion",
                "reason",
                "proposal",
                "evidenceIds",
                "priorityIds",
                "caveats"
              ]
            },
            "maxItems": 5
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown"
                ]
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "family": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable",
                        "forbidden",
                        "unknown"
                      ]
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "family",
                    "status",
                    "count",
                    "limits"
                  ]
                },
                "maxItems": 30
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "calendarReview": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              }
            },
            "required": [
              "status",
              "sources",
              "limits",
              "localDate",
              "calendarReview"
            ],
            "nullable": true
          },
          "waitReason": {
            "type": "string",
            "enum": [
              "structured_inference_budget"
            ]
          },
          "retryAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "status",
          "id",
          "receipt",
          "error",
          "items",
          "coverage"
        ]
      },
      "InsightAnalysisTopicStateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisTopicState"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisTopicState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "missing",
              "pending",
              "queued",
              "running",
              "ready",
              "failed",
              "stale"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "receipt": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "operationKey": {
                "type": "string",
                "format": "uuid",
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
              },
              "acceptedAt": {
                "type": "string",
                "format": "date-time"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              }
            },
            "required": [
              "id",
              "operationKey",
              "acceptedAt",
              "status",
              "language",
              "frameRevision"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_ANALYSIS_FAILED"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          },
          "topic": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 250
              },
              "family": {
                "type": "string",
                "enum": [
                  "documented_attention",
                  "event_opportunity",
                  "priority_review",
                  "recorded_relationship",
                  "recorded_resources",
                  "calendar_preparation",
                  "relationship_continuity",
                  "activity_history"
                ]
              },
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "conclusion": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1200
              },
              "reason": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1200
              },
              "proposal": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1200
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "human_review"
                    ]
                  },
                  "targetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "text",
                  "kind",
                  "targetId"
                ]
              },
              "evidenceIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "maxItems": 100,
                "uniqueItems": true
              },
              "priorityIds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "maxItems": 100,
                "uniqueItems": true
              },
              "caveats": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "reviewAction": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "review_documented_need",
                      "review_event_fit",
                      "reassess_priority",
                      "review_recorded_exchange",
                      "review_recorded_resources",
                      "review_calendar_preparation",
                      "review_relationship_continuity",
                      "review_activity_history"
                    ]
                  },
                  "targetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "id",
                  "type",
                  "targetId"
                ]
              },
              "reappearance": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 800
                  },
                  "evidenceIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "maxItems": 100,
                    "uniqueItems": true
                  }
                },
                "required": [
                  "text",
                  "evidenceIds"
                ],
                "nullable": true
              }
            },
            "required": [
              "id",
              "family",
              "title",
              "conclusion",
              "reason",
              "proposal",
              "evidenceIds",
              "priorityIds",
              "caveats"
            ],
            "nullable": true
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown"
                ]
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "family": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable",
                        "forbidden",
                        "unknown"
                      ]
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "family",
                    "status",
                    "count",
                    "limits"
                  ]
                },
                "maxItems": 30
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "calendarReview": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              }
            },
            "required": [
              "status",
              "sources",
              "limits",
              "localDate",
              "calendarReview"
            ],
            "nullable": true
          },
          "waitReason": {
            "type": "string",
            "enum": [
              "structured_inference_budget"
            ]
          },
          "retryAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "status",
          "id",
          "receipt",
          "error",
          "topic",
          "coverage"
        ]
      },
      "InsightAnalysisEvidenceResultResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisEvidenceResult"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisEvidenceResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "evidence": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "nature": {
                "type": "string",
                "enum": [
                  "declared",
                  "recorded_fact",
                  "prepared_suggestion"
                ]
              },
              "source": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "collection": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  }
                },
                "required": [
                  "collection",
                  "id"
                ],
                "nullable": true
              },
              "contactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "nullable": true
              },
              "observedAt": {
                "type": "string",
                "format": "date-time"
              },
              "occurredAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "occurredOn": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "datePrecision": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              },
              "labelCode": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              },
              "text": {
                "type": "string",
                "minLength": 0,
                "maxLength": 16000
              },
              "facts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$",
                      "description": "Typed admitted fact. contact_marked_local is true/false/null for the current contact marking, not physical location. registration_count counts admitted registered contacts, not families or attendance. Coverage is not preparation progress. DEV extended source facts: recorded_interaction is a dated CRM trace, not an unfulfilled need. recorded_resources use separate currencies and two completed 30-day UTC periods excluding today; monetary fact unit minor:CODE:EXP means divide by 10^EXP. Null totals mean unqualified or excluded records, never zero. They are gross recorded payments, not available cash, donations only, bank settlement or project budget. community_calendar is a calculated civil occasion, not personal free/busy or missing preparation. DEV longitudinal relationship_history and activity_history require contacts, events and registrations together. firstVisibleRegistrationAt is the first visible validated registration inside the 180-day window, not the first-ever relationship. laterRecordedInteractionCount counts strictly later instant-level records; day precision cannot prove ordering. Activity periods are two complete 90-day UTC windows, classified by recorded event start, not registration creation. Distinct contacts, contact-event pairs and per-event averages are different units. comparisonAvailable=false prohibits a trend comparison. Synthetic insight_relationship_history and insight_activity_history source IDs are opaque projections, not event IDs. Window from/splitAt/to are half-open UTC boundaries; the end is excluded. Same explicit group does not prove identical format, audience, attendance, loyalty or causal effectiveness. Archived valid registrations are included as currently recorded; no immutable historical snapshot is implied. Exchange-only continuity is also supported: firstVisibleInteractionAt/lastVisibleInteractionAt and laterRecordedExchangeCount use the first visible instant-level exchange as their reference. laterRecordedInteractionCount remains relative to the first visible registration, and is null without one. firstEverContactAt/firstEverRegistrationAt remain unknown. registrationChronologyKnown=false withholds registration metrics without inventing zero or discarding qualified dated exchanges."
                    },
                    "value": {
                      "oneOf": [
                        {
                          "type": "string",
                          "maxLength": 16000
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "string",
                          "nullable": true,
                          "enum": [
                            null
                          ]
                        }
                      ]
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "nullable": true
                    }
                  },
                  "required": [
                    "code",
                    "value",
                    "unit"
                  ]
                },
                "maxItems": 100
              },
              "references": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "collection": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "contactId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "nullable": true
                    },
                    "quote": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 10000,
                      "nullable": true
                    },
                    "at": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "occurredOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    },
                    "datePrecision": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    }
                  },
                  "required": [
                    "collection",
                    "id",
                    "contactId",
                    "quote",
                    "at",
                    "occurredOn",
                    "datePrecision"
                  ]
                },
                "maxItems": 100
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              }
            },
            "required": [
              "id",
              "nature",
              "source",
              "contactId",
              "observedAt",
              "occurredAt",
              "occurredOn",
              "datePrecision",
              "labelCode",
              "text",
              "facts",
              "references",
              "limits"
            ]
          }
        },
        "required": [
          "id",
          "evidence"
        ]
      },
      "InsightAnalysisPreparationResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAnalysisPreparation"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAnalysisPreparation": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "facts_only"
            ]
          },
          "preparedAt": {
            "type": "string",
            "format": "date-time"
          },
          "frameRevision": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "common": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "personal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "common",
              "personal"
            ]
          },
          "population": {
            "type": "string",
            "enum": [
              "local",
              "global"
            ]
          },
          "observations": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "nature": {
                  "type": "string",
                  "enum": [
                    "declared",
                    "recorded_fact",
                    "prepared_suggestion"
                  ]
                },
                "source": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "collection": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "required": [
                    "collection",
                    "id"
                  ],
                  "nullable": true
                },
                "contactId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "nullable": true
                },
                "observedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "occurredAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "occurredOn": {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                  "nullable": true
                },
                "datePrecision": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "labelCode": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "text": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 16000
                },
                "facts": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "code": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$",
                        "description": "Typed admitted fact. contact_marked_local is true/false/null for the current contact marking, not physical location. registration_count counts admitted registered contacts, not families or attendance. Coverage is not preparation progress. DEV extended source facts: recorded_interaction is a dated CRM trace, not an unfulfilled need. recorded_resources use separate currencies and two completed 30-day UTC periods excluding today; monetary fact unit minor:CODE:EXP means divide by 10^EXP. Null totals mean unqualified or excluded records, never zero. They are gross recorded payments, not available cash, donations only, bank settlement or project budget. community_calendar is a calculated civil occasion, not personal free/busy or missing preparation. DEV longitudinal relationship_history and activity_history require contacts, events and registrations together. firstVisibleRegistrationAt is the first visible validated registration inside the 180-day window, not the first-ever relationship. laterRecordedInteractionCount counts strictly later instant-level records; day precision cannot prove ordering. Activity periods are two complete 90-day UTC windows, classified by recorded event start, not registration creation. Distinct contacts, contact-event pairs and per-event averages are different units. comparisonAvailable=false prohibits a trend comparison. Synthetic insight_relationship_history and insight_activity_history source IDs are opaque projections, not event IDs. Window from/splitAt/to are half-open UTC boundaries; the end is excluded. Same explicit group does not prove identical format, audience, attendance, loyalty or causal effectiveness. Archived valid registrations are included as currently recorded; no immutable historical snapshot is implied. Exchange-only continuity is also supported: firstVisibleInteractionAt/lastVisibleInteractionAt and laterRecordedExchangeCount use the first visible instant-level exchange as their reference. laterRecordedInteractionCount remains relative to the first visible registration, and is null without one. firstEverContactAt/firstEverRegistrationAt remain unknown. registrationChronologyKnown=false withholds registration metrics without inventing zero or discarding qualified dated exchanges."
                      },
                      "value": {
                        "oneOf": [
                          {
                            "type": "string",
                            "maxLength": 16000
                          },
                          {
                            "type": "number"
                          },
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "string",
                            "nullable": true,
                            "enum": [
                              null
                            ]
                          }
                        ]
                      },
                      "unit": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "nullable": true
                      }
                    },
                    "required": [
                      "code",
                      "value",
                      "unit"
                    ]
                  },
                  "maxItems": 100
                },
                "references": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "collection": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "contactId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "nullable": true
                      },
                      "quote": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 10000,
                        "nullable": true
                      },
                      "at": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "occurredOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      },
                      "datePrecision": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      }
                    },
                    "required": [
                      "collection",
                      "id",
                      "contactId",
                      "quote",
                      "at",
                      "occurredOn",
                      "datePrecision"
                    ]
                  },
                  "maxItems": 100
                },
                "limits": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  },
                  "maxItems": 100
                }
              },
              "required": [
                "id",
                "nature",
                "source",
                "contactId",
                "observedAt",
                "occurredAt",
                "occurredOn",
                "datePrecision",
                "labelCode",
                "text",
                "facts",
                "references",
                "limits"
              ]
            },
            "maxItems": 6
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown"
                ]
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "family": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable",
                        "forbidden",
                        "unknown"
                      ]
                    },
                    "count": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "nullable": true
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "family",
                    "status",
                    "count",
                    "limits"
                  ]
                },
                "maxItems": 30
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                "nullable": true
              },
              "calendarReview": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "^[A-Za-z0-9_:.\\-]+$"
              }
            },
            "required": [
              "status",
              "sources",
              "limits",
              "localDate",
              "calendarReview"
            ]
          },
          "privacy": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "personal"
                ]
              },
              "privateDependencies": {
                "type": "array",
                "maxItems": 0,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                }
              }
            },
            "required": [
              "classification",
              "privateDependencies"
            ]
          }
        },
        "required": [
          "status",
          "preparedAt",
          "frameRevision",
          "population",
          "observations",
          "coverage",
          "privacy"
        ]
      },
      "InsightFeedbackStateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightFeedbackState"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightFeedbackState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "declarations": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "declarationId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "actionId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 250
                },
                "actionType": {
                  "type": "string",
                  "enum": [
                    "review_documented_need",
                    "review_event_fit",
                    "reassess_priority",
                    "review_recorded_exchange",
                    "review_recorded_resources",
                    "review_calendar_preparation",
                    "review_relationship_continuity",
                    "review_activity_history"
                  ]
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "done",
                    "not_relevant",
                    "defer"
                  ]
                },
                "active": {
                  "type": "boolean"
                },
                "declaredAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "undoneAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "dueOn": {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                  "nullable": true
                },
                "timeZone": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100,
                  "nullable": true
                },
                "untilAt": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "comment": {
                  "type": "string",
                  "minLength": 0,
                  "maxLength": 2000,
                  "nullable": true
                },
                "subject": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "contact",
                        "event",
                        "priority",
                        "resources",
                        "calendar",
                        "activities"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 4000,
                      "pattern": "\\S"
                    }
                  },
                  "required": [
                    "kind",
                    "label"
                  ],
                  "nullable": true
                },
                "contentState": {
                  "type": "string",
                  "enum": [
                    "readmitted",
                    "redacted"
                  ]
                }
              },
              "required": [
                "declarationId",
                "actionId",
                "actionType",
                "kind",
                "active",
                "declaredAt",
                "undoneAt",
                "dueOn",
                "timeZone",
                "untilAt",
                "comment",
                "subject",
                "contentState"
              ]
            },
            "maxItems": 200
          }
        },
        "required": [
          "actionId",
          "revision",
          "declarations"
        ]
      },
      "InsightFeedbackError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightFeedbackHistoryResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightFeedbackHistory"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightFeedbackHistory": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "actionId": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 250
                },
                "revision": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740990
                },
                "declarations": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "declarationId": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "actionId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 250
                      },
                      "actionType": {
                        "type": "string",
                        "enum": [
                          "review_documented_need",
                          "review_event_fit",
                          "reassess_priority",
                          "review_recorded_exchange",
                          "review_recorded_resources",
                          "review_calendar_preparation",
                          "review_relationship_continuity",
                          "review_activity_history"
                        ]
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "done",
                          "not_relevant",
                          "defer"
                        ]
                      },
                      "active": {
                        "type": "boolean"
                      },
                      "declaredAt": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "undoneAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "dueOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      },
                      "timeZone": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "nullable": true
                      },
                      "untilAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "comment": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 2000,
                        "nullable": true
                      },
                      "subject": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "contact",
                              "event",
                              "priority",
                              "resources",
                              "calendar",
                              "activities"
                            ]
                          },
                          "label": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 4000,
                            "pattern": "\\S"
                          }
                        },
                        "required": [
                          "kind",
                          "label"
                        ],
                        "nullable": true
                      },
                      "contentState": {
                        "type": "string",
                        "enum": [
                          "readmitted",
                          "redacted"
                        ]
                      }
                    },
                    "required": [
                      "declarationId",
                      "actionId",
                      "actionType",
                      "kind",
                      "active",
                      "declaredAt",
                      "undoneAt",
                      "dueOn",
                      "timeZone",
                      "untilAt",
                      "comment",
                      "subject",
                      "contentState"
                    ]
                  },
                  "maxItems": 200
                }
              },
              "required": [
                "actionId",
                "revision",
                "declarations"
              ]
            },
            "maxItems": 50
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000,
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightFeedbackReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightFeedbackReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightFeedbackReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "declare",
              "undo"
            ]
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "declarationId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "actionId",
          "declarationId",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "UnisoftRequest_c7980fb3ed49b957c11a": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "resultId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "topicId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "actionId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250
          },
          "dueOn": {
            "type": "string",
            "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
            "format": "date"
          },
          "timeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Explicit valid IANA time zone. Reconsideration begins at the first existing instant of dueOn in this zone, not at end of day. For a new declaration, this instant must be strictly in the future, including at final admission before writing. Recovery of an existing exact receipt remains possible after expiry."
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "resultId",
          "topicId",
          "actionId",
          "dueOn",
          "timeZone"
        ],
        "additionalProperties": false
      },
      "UnisoftRequest_95afed61f212b9c25f46": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "enum": [
              0
            ]
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "pattern": "^[hH][tT][tT][pP][sS]://",
            "format": "uri",
            "description": "HTTPS callback URL without user information or fragment. Private targets, redirects and unqualified DNS are refused by the owner. Sensitive value: never log or repeat it."
          },
          "signingSecret": {
            "type": "string",
            "minLength": 43,
            "maxLength": 256,
            "pattern": "^[A-Za-z0-9_-]{43,256}$",
            "description": "Caller-provided base64url signing secret, at least 43 characters. Write-only: never repeat in a response, prompt, log or later request unless intentionally rotating it."
          },
          "eventTypes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "insight.analysis.ready",
                "insight.weekly.ready"
              ]
            },
            "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
          }
        },
        "required": [
          "operationKey",
          "expectedRevision",
          "url",
          "signingSecret"
        ],
        "additionalProperties": false
      },
      "InsightWebhookReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWebhookReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWebhookReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "create",
              "update",
              "remove"
            ]
          },
          "destinationId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "destinationId",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "InsightWebhookError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightWebhookListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWebhookList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWebhookList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "eventTypes": {
                  "type": "array",
                  "minItems": 1,
                  "maxItems": 2,
                  "uniqueItems": true,
                  "items": {
                    "type": "string",
                    "enum": [
                      "insight.analysis.ready",
                      "insight.weekly.ready"
                    ]
                  },
                  "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
                },
                "destinationId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "revision": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740990
                },
                "endpointOrigin": {
                  "type": "string",
                  "format": "uri",
                  "maxLength": 2048,
                  "pattern": "^https://"
                },
                "active": {
                  "type": "boolean"
                },
                "updatedAt": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "required": [
                "eventTypes",
                "destinationId",
                "revision",
                "endpointOrigin",
                "active",
                "updatedAt"
              ]
            }
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightWebhookDestinationResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWebhookDestination"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWebhookDestination": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "eventTypes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "insight.analysis.ready",
                "insight.weekly.ready"
              ]
            },
            "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
          },
          "destinationId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "endpointOrigin": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048,
            "pattern": "^https://"
          },
          "active": {
            "type": "boolean"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "eventTypes",
          "destinationId",
          "revision",
          "endpointOrigin",
          "active",
          "updatedAt"
        ]
      },
      "UnisoftRequest_3e0880e63a0e8aadb9d7": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "url": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048,
            "pattern": "^[hH][tT][tT][pP][sS]://",
            "format": "uri",
            "description": "HTTPS callback URL without user information or fragment. Private targets, redirects and unqualified DNS are refused by the owner. Sensitive value: never log or repeat it."
          },
          "signingSecret": {
            "type": "string",
            "minLength": 43,
            "maxLength": 256,
            "pattern": "^[A-Za-z0-9_-]{43,256}$",
            "description": "Caller-provided base64url signing secret, at least 43 characters. Write-only: never repeat in a response, prompt, log or later request unless intentionally rotating it."
          },
          "active": {
            "type": "boolean"
          },
          "eventTypes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "insight.analysis.ready",
                "insight.weekly.ready"
              ]
            },
            "description": "Choix explicite des événements. Omission à la création : analyses seules. L’ajout hebdomadaire exige insight:weekly:read courant ; omission en modification conserve le choix existant. Aucun ancien grant ou destination ne gagne ce type implicitement."
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "url"
            ]
          },
          {
            "required": [
              "signingSecret"
            ]
          },
          {
            "required": [
              "active"
            ]
          },
          {
            "required": [
              "eventTypes"
            ]
          }
        ]
      },
      "InsightWeeklyPreferencesResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPreferences"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPreferences": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          },
          "schedule": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "weekday": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6,
                "description": "0=Sunday, 1=Monday, …, 6=Saturday."
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Explicit valid IANA zone; never inferred from language or organisation name."
              }
            },
            "required": [
              "weekday",
              "localTime",
              "timeZone"
            ],
            "nullable": true
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro",
              null
            ],
            "nullable": true
          },
          "emailEnabled": {
            "type": "boolean"
          },
          "availabilityNoticeEnabled": {
            "type": "boolean"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "revision",
          "schedule",
          "language",
          "emailEnabled",
          "availabilityNoticeEnabled",
          "updatedAt"
        ]
      },
      "InsightWeeklyError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "UnisoftRequest_225b2a9e388335330940": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "schedule": {
            "type": "object",
            "properties": {
              "weekday": {
                "type": "integer",
                "minimum": 0,
                "maximum": 6,
                "description": "0=Sunday, 1=Monday, …, 6=Saturday."
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Explicit valid IANA zone; never inferred from language or organisation name."
              }
            },
            "required": [
              "weekday",
              "localTime",
              "timeZone"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro",
              null
            ],
            "nullable": true
          },
          "emailEnabled": {
            "type": "boolean"
          },
          "availabilityNoticeEnabled": {
            "type": "boolean"
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "schedule"
            ]
          },
          {
            "required": [
              "language"
            ]
          },
          {
            "required": [
              "emailEnabled"
            ]
          },
          {
            "required": [
              "availabilityNoticeEnabled"
            ]
          }
        ]
      },
      "InsightWeeklyPreferencesReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPreferencesReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPreferencesReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "saveWeeklyPreferences"
            ]
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "InsightWeeklyReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "action": {
            "type": "string",
            "enum": [
              "request"
            ]
          },
          "occurrenceId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          },
          "preferenceRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740990
          }
        },
        "required": [
          "operationKey",
          "action",
          "occurrenceId",
          "status",
          "acceptedAt",
          "preferenceRevision"
        ]
      },
      "InsightWeeklyListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "reportId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "reportVersion": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 9007199254740990
                },
                "occurrence": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "occurrenceId": {
                      "type": "string",
                      "pattern": "^[a-f0-9]{64}$"
                    },
                    "preferenceRevision": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740990
                    },
                    "calendarVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740990
                    },
                    "localDate": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$"
                    },
                    "localTime": {
                      "type": "string",
                      "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
                    },
                    "timeZone": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                      "description": "Explicit valid IANA zone; never inferred from language or organisation name."
                    },
                    "scheduledAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "prepareAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "period": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "from": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "to": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "startAdjustment": {
                          "type": "string",
                          "enum": [
                            "gap_to_first_existing_instant",
                            null
                          ],
                          "nullable": true
                        },
                        "coverage": {
                          "type": "string",
                          "enum": [
                            "civil_boundary_adjusted",
                            "theoretical_civil_week"
                          ]
                        }
                      },
                      "required": [
                        "from",
                        "to",
                        "startAdjustment",
                        "coverage"
                      ]
                    },
                    "language": {
                      "type": "string",
                      "enum": [
                        "fr",
                        "en",
                        "he",
                        "de",
                        "es",
                        "gr",
                        "ro"
                      ]
                    }
                  },
                  "required": [
                    "occurrenceId",
                    "preferenceRevision",
                    "calendarVersion",
                    "localDate",
                    "localTime",
                    "timeZone",
                    "scheduledAt",
                    "prepareAt",
                    "period",
                    "language"
                  ]
                },
                "preparedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "publishedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "language": {
                  "type": "string",
                  "enum": [
                    "fr",
                    "en",
                    "he",
                    "de",
                    "es",
                    "gr",
                    "ro"
                  ]
                }
              },
              "required": [
                "reportId",
                "reportVersion",
                "occurrence",
                "preparedAt",
                "publishedAt",
                "language"
              ]
            },
            "maxItems": 20
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1500,
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightWeeklyStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyStatus"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyStatus": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "incomplete",
              "scheduled",
              "queued",
              "running",
              "budget_waiting",
              "prepared",
              "ready",
              "stale",
              "failed"
            ]
          },
          "occurrence": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "occurrenceId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "preferenceRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740990
              },
              "calendarVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$"
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Explicit valid IANA zone; never inferred from language or organisation name."
              },
              "scheduledAt": {
                "type": "string",
                "format": "date-time"
              },
              "prepareAt": {
                "type": "string",
                "format": "date-time"
              },
              "period": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "to": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "startAdjustment": {
                    "type": "string",
                    "enum": [
                      "gap_to_first_existing_instant",
                      null
                    ],
                    "nullable": true
                  },
                  "coverage": {
                    "type": "string",
                    "enum": [
                      "civil_boundary_adjusted",
                      "theoretical_civil_week"
                    ]
                  }
                },
                "required": [
                  "from",
                  "to",
                  "startAdjustment",
                  "coverage"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ]
              }
            },
            "required": [
              "occurrenceId",
              "preferenceRevision",
              "calendarVersion",
              "localDate",
              "localTime",
              "timeZone",
              "scheduledAt",
              "prepareAt",
              "period",
              "language"
            ],
            "nullable": true
          },
          "report": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "reportId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "reportVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              }
            },
            "required": [
              "reportId",
              "reportVersion"
            ],
            "nullable": true
          },
          "error": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "INSIGHT_WEEKLY_SCHEDULE_REQUIRED",
                  "INSIGHT_WEEKLY_LANGUAGE_REQUIRED",
                  "INSIGHT_WEEKLY_CALENDAR_UNAVAILABLE",
                  "INSIGHT_WEEKLY_PREFERENCE_CHANGED",
                  "INSIGHT_WEEKLY_CLAIM_LOST",
                  "INSIGHT_WEEKLY_UNAVAILABLE",
                  "INSIGHT_WEEKLY_CAPACITY",
                  "INSIGHT_WEEKLY_ANALYSIS_STALE",
                  "INSIGHT_WEEKLY_ANALYSIS_FORBIDDEN",
                  "INSIGHT_WEEKLY_ANALYSIS_UNAVAILABLE",
                  "INSIGHT_WEEKLY_ANALYSIS_INPUT_INVALID",
                  "INSIGHT_FORBIDDEN",
                  "INSIGHT_INPUT_INVALID"
                ]
              }
            },
            "required": [
              "code"
            ],
            "nullable": true
          }
        },
        "required": [
          "status",
          "occurrence",
          "report",
          "error"
        ]
      },
      "InsightWeeklyReportResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyReport"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyReport": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "ready",
              "unavailable"
            ]
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "occurrence": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "occurrenceId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "preferenceRevision": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740990
              },
              "calendarVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              },
              "localDate": {
                "type": "string",
                "format": "date",
                "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$"
              },
              "localTime": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
                "description": "Explicit valid IANA zone; never inferred from language or organisation name."
              },
              "scheduledAt": {
                "type": "string",
                "format": "date-time"
              },
              "prepareAt": {
                "type": "string",
                "format": "date-time"
              },
              "period": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "to": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "startAdjustment": {
                    "type": "string",
                    "enum": [
                      "gap_to_first_existing_instant",
                      null
                    ],
                    "nullable": true
                  },
                  "coverage": {
                    "type": "string",
                    "enum": [
                      "civil_boundary_adjusted",
                      "theoretical_civil_week"
                    ]
                  }
                },
                "required": [
                  "from",
                  "to",
                  "startAdjustment",
                  "coverage"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ]
              }
            },
            "required": [
              "occurrenceId",
              "preferenceRevision",
              "calendarVersion",
              "localDate",
              "localTime",
              "timeZone",
              "scheduledAt",
              "prepareAt",
              "period",
              "language"
            ]
          },
          "preparedAt": {
            "type": "string",
            "format": "date-time"
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time"
          },
          "language": {
            "type": "string",
            "enum": [
              "fr",
              "en",
              "he",
              "de",
              "es",
              "gr",
              "ro"
            ]
          },
          "frame": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "revision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740990
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740990
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              },
              "mission": {
                "type": "string",
                "maxLength": 8000
              },
              "audience": {
                "type": "string",
                "maxLength": 8000
              },
              "primaryPriority": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1
                  },
                  "text": {
                    "type": "string",
                    "maxLength": 4000,
                    "minLength": 1
                  },
                  "dueOn": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  }
                },
                "required": [
                  "id",
                  "text",
                  "dueOn"
                ],
                "nullable": true
              },
              "secondaryPriorities": {
                "type": "array",
                "maxItems": 20,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1
                    },
                    "text": {
                      "type": "string",
                      "maxLength": 4000,
                      "minLength": 1
                    },
                    "dueOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "text",
                    "dueOn"
                  ]
                }
              }
            },
            "required": [
              "revision",
              "mission",
              "audience",
              "primaryPriority",
              "secondaryPriorities"
            ],
            "nullable": true
          },
          "comparison": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "comparable",
                  "unavailable"
                ]
              },
              "baseline": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "reportId": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$"
                  },
                  "reportVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740990
                  }
                },
                "required": [
                  "reportId",
                  "reportVersion"
                ],
                "nullable": true
              },
              "reasonCodes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              },
              "changes": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "declared_priority_changed"
                          ]
                        },
                        "nature": {
                          "type": "string",
                          "enum": [
                            "declared"
                          ]
                        },
                        "source": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "collection",
                            "id"
                          ]
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        },
                        "details": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "before": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "maxLength": 100,
                                  "minLength": 1
                                },
                                "text": {
                                  "type": "string",
                                  "maxLength": 4000,
                                  "minLength": 1
                                },
                                "dueOn": {
                                  "type": "string",
                                  "format": "date",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                                  "nullable": true
                                }
                              },
                              "required": [
                                "id",
                                "text",
                                "dueOn"
                              ],
                              "nullable": true
                            },
                            "after": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "maxLength": 100,
                                  "minLength": 1
                                },
                                "text": {
                                  "type": "string",
                                  "maxLength": 4000,
                                  "minLength": 1
                                },
                                "dueOn": {
                                  "type": "string",
                                  "format": "date",
                                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                                  "nullable": true
                                }
                              },
                              "required": [
                                "id",
                                "text",
                                "dueOn"
                              ],
                              "nullable": true
                            }
                          },
                          "required": [
                            "before",
                            "after"
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "nature",
                        "source",
                        "limits",
                        "details"
                      ]
                    },
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "appeared_in_admitted_data"
                          ]
                        },
                        "nature": {
                          "type": "string",
                          "enum": [
                            "recorded_fact",
                            "prepared_suggestion"
                          ]
                        },
                        "source": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "collection",
                            "id"
                          ]
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        },
                        "details": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "subject": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "contact",
                                    "event",
                                    "priority",
                                    "resources",
                                    "calendar",
                                    "activities"
                                  ]
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 4000,
                                  "pattern": "\\S"
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "nullable": true
                            },
                            "observedAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "occurredAt": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "occurredOn": {
                              "type": "string",
                              "format": "date",
                              "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                              "nullable": true
                            },
                            "datePrecision": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "pattern": "^[A-Za-z0-9_:.\\-]+$"
                            }
                          },
                          "required": [
                            "subject",
                            "observedAt",
                            "occurredAt",
                            "occurredOn",
                            "datePrecision"
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "nature",
                        "source",
                        "limits",
                        "details"
                      ]
                    },
                    {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "review_declared"
                          ]
                        },
                        "nature": {
                          "type": "string",
                          "enum": [
                            "declared"
                          ]
                        },
                        "source": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            }
                          },
                          "required": [
                            "collection",
                            "id"
                          ]
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        },
                        "details": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "declarationKind": {
                              "type": "string",
                              "enum": [
                                "done",
                                "not_relevant",
                                "defer"
                              ]
                            },
                            "declaredAt": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "subject": {
                              "type": "object",
                              "additionalProperties": false,
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "enum": [
                                    "contact",
                                    "event",
                                    "priority",
                                    "resources",
                                    "calendar",
                                    "activities"
                                  ]
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 4000,
                                  "pattern": "\\S"
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "nullable": true
                            }
                          },
                          "required": [
                            "declarationKind",
                            "declaredAt",
                            "subject"
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "nature",
                        "source",
                        "limits",
                        "details"
                      ]
                    }
                  ]
                },
                "maxItems": 3
              }
            },
            "required": [
              "status",
              "baseline",
              "reasonCodes",
              "changes"
            ]
          },
          "coverage": {
            "oneOf": [
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "partial",
                      "unknown"
                    ]
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "family": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "unavailable",
                            "forbidden",
                            "unknown"
                          ]
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "nullable": true
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "family",
                        "status",
                        "count",
                        "limits"
                      ]
                    },
                    "maxItems": 30
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  },
                  "localDate": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  },
                  "calendarReview": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  }
                },
                "required": [
                  "status",
                  "sources",
                  "limits",
                  "localDate",
                  "calendarReview"
                ]
              },
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "unavailable"
                    ]
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  }
                },
                "required": [
                  "status",
                  "limits"
                ]
              }
            ]
          },
          "result": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "ready"
                ]
              },
              "generatedAt": {
                "type": "string",
                "format": "date-time"
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ],
                "description": "API language: fr French, en English, he Hebrew, de German, es Spanish, gr Greek, ro Romanian. Omitted language defaults to fr."
              },
              "frameRevision": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "common": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "personal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "common",
                  "personal"
                ]
              },
              "summary": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2400
                  },
                  "evidenceIds": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "maxItems": 100,
                    "uniqueItems": true
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "facts_only",
                      "admitted_topics"
                    ]
                  }
                },
                "required": [
                  "text",
                  "evidenceIds",
                  "mode"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 250
                    },
                    "family": {
                      "type": "string",
                      "enum": [
                        "documented_attention",
                        "event_opportunity",
                        "priority_review",
                        "recorded_relationship",
                        "recorded_resources",
                        "calendar_preparation",
                        "relationship_continuity",
                        "activity_history"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "human_review"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "text",
                        "kind",
                        "targetId"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "priorityIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "caveats": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    },
                    "reviewAction": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "review_documented_need",
                            "review_event_fit",
                            "reassess_priority",
                            "review_recorded_exchange",
                            "review_recorded_resources",
                            "review_calendar_preparation",
                            "review_relationship_continuity",
                            "review_activity_history"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "type",
                        "targetId"
                      ]
                    },
                    "reappearance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 800
                        },
                        "evidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "maxItems": 100,
                          "uniqueItems": true
                        }
                      },
                      "required": [
                        "text",
                        "evidenceIds"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "family",
                    "title",
                    "conclusion",
                    "reason",
                    "proposal",
                    "evidenceIds",
                    "priorityIds",
                    "caveats",
                    "reviewAction",
                    "reappearance"
                  ]
                },
                "maxItems": 3
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "nature": {
                      "type": "string",
                      "enum": [
                        "declared",
                        "recorded_fact",
                        "prepared_suggestion"
                      ]
                    },
                    "source": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ],
                      "nullable": true
                    },
                    "contactId": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "nullable": true
                    },
                    "observedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "occurredAt": {
                      "type": "string",
                      "format": "date-time",
                      "nullable": true
                    },
                    "occurredOn": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                      "nullable": true
                    },
                    "datePrecision": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "labelCode": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "text": {
                      "type": "string",
                      "minLength": 0,
                      "maxLength": 16000
                    },
                    "facts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "code": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$",
                            "description": "Typed admitted fact. contact_marked_local is true/false/null for the current contact marking, not physical location. registration_count counts admitted registered contacts, not families or attendance. Coverage is not preparation progress. DEV extended source facts: recorded_interaction is a dated CRM trace, not an unfulfilled need. recorded_resources use separate currencies and two completed 30-day UTC periods excluding today; monetary fact unit minor:CODE:EXP means divide by 10^EXP. Null totals mean unqualified or excluded records, never zero. They are gross recorded payments, not available cash, donations only, bank settlement or project budget. community_calendar is a calculated civil occasion, not personal free/busy or missing preparation. DEV longitudinal relationship_history and activity_history require contacts, events and registrations together. firstVisibleRegistrationAt is the first visible validated registration inside the 180-day window, not the first-ever relationship. laterRecordedInteractionCount counts strictly later instant-level records; day precision cannot prove ordering. Activity periods are two complete 90-day UTC windows, classified by recorded event start, not registration creation. Distinct contacts, contact-event pairs and per-event averages are different units. comparisonAvailable=false prohibits a trend comparison. Synthetic insight_relationship_history and insight_activity_history source IDs are opaque projections, not event IDs. Window from/splitAt/to are half-open UTC boundaries; the end is excluded. Same explicit group does not prove identical format, audience, attendance, loyalty or causal effectiveness. Archived valid registrations are included as currently recorded; no immutable historical snapshot is implied. Exchange-only continuity is also supported: firstVisibleInteractionAt/lastVisibleInteractionAt and laterRecordedExchangeCount use the first visible instant-level exchange as their reference. laterRecordedInteractionCount remains relative to the first visible registration, and is null without one. firstEverContactAt/firstEverRegistrationAt remain unknown. registrationChronologyKnown=false withholds registration metrics without inventing zero or discarding qualified dated exchanges."
                          },
                          "value": {
                            "oneOf": [
                              {
                                "type": "string",
                                "maxLength": 16000
                              },
                              {
                                "type": "number"
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "string",
                                "nullable": true,
                                "enum": [
                                  null
                                ]
                              }
                            ]
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "nullable": true
                          }
                        },
                        "required": [
                          "code",
                          "value",
                          "unit"
                        ]
                      },
                      "maxItems": 100
                    },
                    "references": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "collection": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "contactId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "nullable": true
                          },
                          "quote": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 10000,
                            "nullable": true
                          },
                          "at": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                          },
                          "occurredOn": {
                            "type": "string",
                            "format": "date",
                            "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                            "nullable": true
                          },
                          "datePrecision": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          }
                        },
                        "required": [
                          "collection",
                          "id",
                          "contactId",
                          "quote",
                          "at",
                          "occurredOn",
                          "datePrecision"
                        ]
                      },
                      "maxItems": 100
                    },
                    "limits": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    }
                  },
                  "required": [
                    "id",
                    "nature",
                    "source",
                    "contactId",
                    "observedAt",
                    "occurredAt",
                    "occurredOn",
                    "datePrecision",
                    "labelCode",
                    "text",
                    "facts",
                    "references",
                    "limits"
                  ]
                },
                "maxItems": 120
              },
              "clarifications": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "text": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    }
                  },
                  "required": [
                    "text"
                  ]
                },
                "maxItems": 1
              },
              "coverage": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "complete",
                      "partial",
                      "unknown"
                    ]
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "family": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "unavailable",
                            "forbidden",
                            "unknown"
                          ]
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "nullable": true
                        },
                        "limits": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200,
                            "pattern": "^[A-Za-z0-9_:.\\-]+$"
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "family",
                        "status",
                        "count",
                        "limits"
                      ]
                    },
                    "maxItems": 30
                  },
                  "limits": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "pattern": "^[A-Za-z0-9_:.\\-]+$"
                    },
                    "maxItems": 100
                  },
                  "localDate": {
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                    "nullable": true
                  },
                  "calendarReview": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$"
                  }
                },
                "required": [
                  "status",
                  "sources",
                  "limits",
                  "localDate",
                  "calendarReview"
                ]
              },
              "privacy": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "classification": {
                    "type": "string",
                    "enum": [
                      "personal"
                    ]
                  },
                  "privateDependencies": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "personal_frame",
                        "constraints",
                        "enrichment"
                      ]
                    },
                    "maxItems": 3,
                    "uniqueItems": true
                  }
                },
                "required": [
                  "classification",
                  "privateDependencies"
                ]
              }
            },
            "required": [
              "version",
              "status",
              "generatedAt",
              "language",
              "frameRevision",
              "summary",
              "topics",
              "evidence",
              "clarifications",
              "coverage",
              "privacy"
            ],
            "nullable": true
          },
          "privacy": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "personal"
                ]
              }
            },
            "required": [
              "classification"
            ]
          }
        },
        "required": [
          "status",
          "reportId",
          "reportVersion",
          "occurrence",
          "preparedAt",
          "publishedAt",
          "language",
          "frame",
          "comparison",
          "coverage",
          "result",
          "privacy"
        ]
      },
      "InsightWeeklyPdfReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "documentId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "projection": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          },
          "acceptedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "operationKey",
          "documentId",
          "reportId",
          "reportVersion",
          "projection",
          "acceptedAt"
        ]
      },
      "InsightWeeklyPdfError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightWeeklyPdfMetadataResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfMetadata"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfMetadata": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "documentId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "reportVersion": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740990
          },
          "projection": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "ready",
              "refused",
              "failed"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "contentDigest": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "nullable": true
          },
          "bytes": {
            "type": "integer",
            "minimum": 5,
            "maximum": 4194304,
            "nullable": true
          },
          "filename": {
            "type": "string",
            "minLength": 5,
            "maxLength": 180,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*\\.pdf$",
            "nullable": true
          }
        },
        "required": [
          "documentId",
          "reportId",
          "reportVersion",
          "projection",
          "state",
          "createdAt",
          "updatedAt",
          "contentDigest",
          "sha256",
          "bytes",
          "filename"
        ]
      },
      "InsightWeeklyPdfPreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfPreview"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfPreview": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "purpose": {
            "type": "string",
            "enum": [
              "shareable"
            ]
          },
          "reportRef": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "reportId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "reportVersion": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740990
              }
            },
            "required": [
              "reportId",
              "reportVersion"
            ]
          },
          "projectionRef": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "documentId": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "projectionVersion": {
                "type": "integer",
                "enum": [
                  1
                ]
              }
            },
            "required": [
              "documentId",
              "projectionVersion"
            ]
          },
          "inputVersion": {
            "type": "integer",
            "enum": [
              1
            ]
          },
          "contentDigest": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "complete",
                  "partial",
                  "unknown",
                  "unavailable"
                ]
              }
            },
            "required": [
              "status"
            ]
          },
          "omissions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9_:.\\-]+$"
            }
          },
          "content": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "version": {
                "type": "integer",
                "enum": [
                  1
                ]
              },
              "brand": {
                "type": "string",
                "enum": [
                  "Unisoft"
                ]
              },
              "language": {
                "type": "string",
                "enum": [
                  "fr",
                  "en",
                  "he",
                  "de",
                  "es",
                  "gr",
                  "ro"
                ]
              },
              "labels": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "period": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "observedAt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "attention": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "conclusion": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "proposal": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "coverage": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "omissions": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "footer": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "privacyNotice": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "coveragePartial": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "required": [
                  "title",
                  "period",
                  "observedAt",
                  "summary",
                  "attention",
                  "conclusion",
                  "reason",
                  "proposal",
                  "coverage",
                  "omissions",
                  "footer",
                  "privacyNotice",
                  "coveragePartial"
                ]
              },
              "period": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "from": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "to": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "localFrom": {
                    "type": "string",
                    "format": "date"
                  },
                  "localTo": {
                    "type": "string",
                    "format": "date"
                  },
                  "timeZone": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "from",
                  "to",
                  "localFrom",
                  "localTo",
                  "timeZone"
                ]
              },
              "preparedAt": {
                "type": "string",
                "format": "date-time"
              },
              "publishedAt": {
                "type": "string",
                "format": "date-time"
              },
              "summary": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2400
              },
              "topics": {
                "type": "array",
                "maxItems": 3,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    }
                  },
                  "required": [
                    "title",
                    "conclusion",
                    "reason",
                    "proposal"
                  ]
                }
              },
              "coveragePartial": {
                "type": "boolean"
              },
              "privacyNotice": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000
              }
            },
            "required": [
              "version",
              "brand",
              "language",
              "labels",
              "period",
              "preparedAt",
              "publishedAt",
              "summary",
              "topics",
              "coveragePartial",
              "privacyNotice"
            ]
          }
        },
        "required": [
          "purpose",
          "reportRef",
          "projectionRef",
          "inputVersion",
          "contentDigest",
          "coverage",
          "omissions",
          "content"
        ]
      },
      "InsightWeeklyPdfContentResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightWeeklyPdfContent"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightWeeklyPdfContent": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "documentId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "mimeType": {
            "type": "string",
            "enum": [
              "application/pdf"
            ]
          },
          "filename": {
            "type": "string",
            "minLength": 5,
            "maxLength": 180,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*\\.pdf$"
          },
          "bytes": {
            "type": "integer",
            "minimum": 5,
            "maximum": 4194304
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "contentBase64": {
            "type": "string",
            "maxLength": 5592408,
            "pattern": "^[A-Za-z0-9+/]*={0,2}$"
          }
        },
        "required": [
          "documentId",
          "mimeType",
          "filename",
          "bytes",
          "sha256",
          "contentBase64"
        ]
      },
      "InsightNotificationsPreferencesResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightNotificationsPreferences"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightNotificationsPreferences": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "revision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "alertsEnabled": {
            "type": "boolean"
          },
          "timeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
            "nullable": true
          },
          "nightEnabled": {
            "type": "boolean",
            "nullable": true
          },
          "quietHours": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "from": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "to": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              }
            },
            "required": [
              "from",
              "to"
            ],
            "nullable": true
          },
          "shabbatEnabled": {
            "type": "boolean"
          },
          "holidaysEnabled": {
            "type": "boolean"
          },
          "location": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "\\S"
              },
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              },
              "country": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "israel": {
                "type": "boolean"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$"
              },
              "confirmed": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "basis": {
                "type": "string",
                "enum": [
                  "declared_city"
                ]
              }
            },
            "required": [
              "label",
              "latitude",
              "longitude",
              "country",
              "israel",
              "timeZone",
              "confirmed",
              "basis"
            ],
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "required": [
          "revision",
          "alertsEnabled",
          "timeZone",
          "nightEnabled",
          "quietHours",
          "shabbatEnabled",
          "holidaysEnabled",
          "location",
          "updatedAt"
        ]
      },
      "InsightNotificationsError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "UnisoftRequest_e507089f51f89fe39e78": {
        "type": "object",
        "properties": {
          "operationKey": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "alertsEnabled": {
            "type": "boolean"
          },
          "timeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$",
            "nullable": true
          },
          "nightEnabled": {
            "type": "boolean",
            "nullable": true
          },
          "quietHours": {
            "type": "object",
            "properties": {
              "from": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              },
              "to": {
                "type": "string",
                "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
              }
            },
            "required": [
              "from",
              "to"
            ],
            "additionalProperties": false,
            "nullable": true
          },
          "shabbatEnabled": {
            "type": "boolean"
          },
          "holidaysEnabled": {
            "type": "boolean"
          },
          "location": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "pattern": "\\S"
              },
              "latitude": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "longitude": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              },
              "country": {
                "type": "string",
                "pattern": "^[A-Z]{2}$"
              },
              "israel": {
                "type": "boolean"
              },
              "timeZone": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100,
                "pattern": "^\\w+(?:/[A-Za-z0-9_+.\\-]+)*$"
              },
              "confirmed": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "basis": {
                "type": "string",
                "enum": [
                  "declared_city"
                ]
              }
            },
            "required": [
              "label",
              "latitude",
              "longitude",
              "country",
              "israel",
              "timeZone",
              "confirmed",
              "basis"
            ],
            "additionalProperties": false,
            "nullable": true
          }
        },
        "required": [
          "operationKey",
          "expectedRevision"
        ],
        "additionalProperties": false,
        "anyOf": [
          {
            "required": [
              "alertsEnabled"
            ]
          },
          {
            "required": [
              "timeZone"
            ]
          },
          {
            "required": [
              "nightEnabled"
            ]
          },
          {
            "required": [
              "quietHours"
            ]
          },
          {
            "required": [
              "shabbatEnabled"
            ]
          },
          {
            "required": [
              "holidaysEnabled"
            ]
          },
          {
            "required": [
              "location"
            ]
          }
        ]
      },
      "InsightNotificationsReceiptResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightNotificationsReceipt"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightNotificationsReceipt": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "saveDeliveryPreferences"
            ]
          },
          "operationKey": {
            "type": "string",
            "format": "uuid",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740989
          },
          "appliedRevision": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740989
          },
          "appliedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "action",
          "operationKey",
          "expectedRevision",
          "appliedRevision",
          "appliedAt"
        ]
      },
      "InsightNotificationsStatusResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightNotificationsStatus"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightNotificationsStatus": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "families": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "alert": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "optedIn": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "allowed",
                      "deferred",
                      "unknown",
                      "refused",
                      "disabled"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$",
                    "nullable": true
                  },
                  "retryAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "enabled",
                  "optedIn",
                  "status",
                  "reason",
                  "retryAt"
                ]
              },
              "weekly_notice": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "optedIn": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "allowed",
                      "deferred",
                      "unknown",
                      "refused",
                      "disabled"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$",
                    "nullable": true
                  },
                  "retryAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "enabled",
                  "optedIn",
                  "status",
                  "reason",
                  "retryAt"
                ]
              },
              "weekly_email": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "optedIn": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "allowed",
                      "deferred",
                      "unknown",
                      "refused",
                      "disabled"
                    ]
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "pattern": "^[A-Za-z0-9_:.\\-]+$",
                    "nullable": true
                  },
                  "retryAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                },
                "required": [
                  "enabled",
                  "optedIn",
                  "status",
                  "reason",
                  "retryAt"
                ]
              }
            },
            "required": [
              "alert",
              "weekly_notice",
              "weekly_email"
            ]
          },
          "counts": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "queued": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "held": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "sending": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "awaiting_email": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "accepted": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "refused": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              },
              "uncertain": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740989
              }
            },
            "required": [
              "queued",
              "held",
              "sending",
              "awaiting_email",
              "accepted",
              "refused",
              "uncertain"
            ]
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "partial"
                ]
              },
              "limits": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                }
              }
            },
            "required": [
              "status",
              "limits"
            ]
          }
        },
        "required": [
          "families",
          "counts",
          "coverage"
        ]
      },
      "InsightAlertsListResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAlertsList"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAlertsList": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "alertId": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "deliveryStatus": {
                  "type": "string",
                  "enum": [
                    "queued",
                    "held",
                    "sending",
                    "awaiting_email",
                    "accepted",
                    "refused",
                    "uncertain"
                  ]
                },
                "subjectCount": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 10,
                  "nullable": true
                },
                "admission": {
                  "type": "string",
                  "enum": [
                    "ready",
                    "unavailable"
                  ]
                }
              },
              "required": [
                "alertId",
                "createdAt",
                "deliveryStatus",
                "subjectCount",
                "admission"
              ]
            },
            "maxItems": 20
          },
          "hasMore": {
            "type": "boolean"
          },
          "nextCursor": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1500,
            "nullable": true
          }
        },
        "required": [
          "items",
          "hasMore",
          "nextCursor"
        ]
      },
      "InsightAlertsError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "InsightAlertResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/InsightAlert"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "InsightAlert": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "alertId": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "status": {
            "type": "string",
            "enum": [
              "ready",
              "unavailable"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "deliveryStatus": {
            "type": "string",
            "enum": [
              "queued",
              "held",
              "sending",
              "awaiting_email",
              "accepted",
              "refused",
              "uncertain"
            ]
          },
          "subjects": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "topic": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 250
                    },
                    "family": {
                      "type": "string",
                      "enum": [
                        "documented_attention",
                        "event_opportunity",
                        "priority_review",
                        "recorded_relationship",
                        "recorded_resources",
                        "calendar_preparation",
                        "relationship_continuity",
                        "activity_history"
                      ]
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "conclusion": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "reason": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1200
                    },
                    "proposal": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1200
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "human_review"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "text",
                        "kind",
                        "targetId"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "priorityIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "maxItems": 100,
                      "uniqueItems": true
                    },
                    "caveats": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "maxItems": 100
                    },
                    "reviewAction": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "review_documented_need",
                            "review_event_fit",
                            "reassess_priority",
                            "review_recorded_exchange",
                            "review_recorded_resources",
                            "review_calendar_preparation",
                            "review_relationship_continuity",
                            "review_activity_history"
                          ]
                        },
                        "targetId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "id",
                        "type",
                        "targetId"
                      ]
                    },
                    "reappearance": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 800
                        },
                        "evidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "maxItems": 100,
                          "uniqueItems": true
                        }
                      },
                      "required": [
                        "text",
                        "evidenceIds"
                      ],
                      "nullable": true
                    }
                  },
                  "required": [
                    "id",
                    "family",
                    "title",
                    "conclusion",
                    "reason",
                    "proposal",
                    "evidenceIds",
                    "priorityIds",
                    "caveats",
                    "reviewAction",
                    "reappearance"
                  ]
                },
                "mode": {
                  "type": "string",
                  "enum": [
                    "ordinary",
                    "deferred_new_deadline"
                  ]
                },
                "deadline": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "event_start"
                      ]
                    },
                    "sourceRef": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "enum": [
                            "pe"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ]
                    },
                    "deadlineAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "kind",
                    "sourceRef",
                    "deadlineAt"
                  ]
                },
                "whyNow": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "code": {
                      "type": "string",
                      "enum": [
                        "event_before_next_weekly",
                        "same_event_deadline_advanced_before_defer"
                      ]
                    },
                    "deadlineAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "nextWeeklyAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 20,
                      "uniqueItems": true
                    },
                    "costOfWaitingCode": {
                      "type": "string",
                      "enum": [
                        "event_starts_before_theoretical_report",
                        "event_now_precedes_defer_and_weekly"
                      ]
                    }
                  },
                  "required": [
                    "code",
                    "deadlineAt",
                    "nextWeeklyAt",
                    "evidenceIds",
                    "costOfWaitingCode"
                  ]
                },
                "deadlineChange": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "previousAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "currentAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "sourceRef": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "collection": {
                          "type": "string",
                          "enum": [
                            "pe"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "collection",
                        "id"
                      ]
                    },
                    "evidenceIds": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "maxItems": 20,
                      "uniqueItems": true
                    }
                  },
                  "required": [
                    "previousAt",
                    "currentAt",
                    "sourceRef",
                    "evidenceIds"
                  ],
                  "nullable": true
                },
                "reportMaintained": {
                  "type": "boolean"
                },
                "deferredUntil": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "evidence": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "nature": {
                        "type": "string",
                        "enum": [
                          "declared",
                          "recorded_fact",
                          "prepared_suggestion"
                        ]
                      },
                      "source": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "collection": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          }
                        },
                        "required": [
                          "collection",
                          "id"
                        ],
                        "nullable": true
                      },
                      "contactId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "nullable": true
                      },
                      "observedAt": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "occurredAt": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                      },
                      "occurredOn": {
                        "type": "string",
                        "format": "date",
                        "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                        "nullable": true
                      },
                      "datePrecision": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "labelCode": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200,
                        "pattern": "^[A-Za-z0-9_:.\\-]+$"
                      },
                      "text": {
                        "type": "string",
                        "minLength": 0,
                        "maxLength": 16000
                      },
                      "facts": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "code": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "pattern": "^[A-Za-z0-9_:.\\-]+$",
                              "description": "Typed admitted fact. contact_marked_local is true/false/null for the current contact marking, not physical location. registration_count counts admitted registered contacts, not families or attendance. Coverage is not preparation progress. DEV extended source facts: recorded_interaction is a dated CRM trace, not an unfulfilled need. recorded_resources use separate currencies and two completed 30-day UTC periods excluding today; monetary fact unit minor:CODE:EXP means divide by 10^EXP. Null totals mean unqualified or excluded records, never zero. They are gross recorded payments, not available cash, donations only, bank settlement or project budget. community_calendar is a calculated civil occasion, not personal free/busy or missing preparation. DEV longitudinal relationship_history and activity_history require contacts, events and registrations together. firstVisibleRegistrationAt is the first visible validated registration inside the 180-day window, not the first-ever relationship. laterRecordedInteractionCount counts strictly later instant-level records; day precision cannot prove ordering. Activity periods are two complete 90-day UTC windows, classified by recorded event start, not registration creation. Distinct contacts, contact-event pairs and per-event averages are different units. comparisonAvailable=false prohibits a trend comparison. Synthetic insight_relationship_history and insight_activity_history source IDs are opaque projections, not event IDs. Window from/splitAt/to are half-open UTC boundaries; the end is excluded. Same explicit group does not prove identical format, audience, attendance, loyalty or causal effectiveness. Archived valid registrations are included as currently recorded; no immutable historical snapshot is implied. Exchange-only continuity is also supported: firstVisibleInteractionAt/lastVisibleInteractionAt and laterRecordedExchangeCount use the first visible instant-level exchange as their reference. laterRecordedInteractionCount remains relative to the first visible registration, and is null without one. firstEverContactAt/firstEverRegistrationAt remain unknown. registrationChronologyKnown=false withholds registration metrics without inventing zero or discarding qualified dated exchanges."
                            },
                            "value": {
                              "oneOf": [
                                {
                                  "type": "string",
                                  "maxLength": 16000
                                },
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "string",
                                  "nullable": true,
                                  "enum": [
                                    null
                                  ]
                                }
                              ]
                            },
                            "unit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100,
                              "nullable": true
                            }
                          },
                          "required": [
                            "code",
                            "value",
                            "unit"
                          ]
                        },
                        "maxItems": 50
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "collection": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "contactId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "nullable": true
                            },
                            "quote": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 10000,
                              "nullable": true
                            },
                            "at": {
                              "type": "string",
                              "format": "date-time",
                              "nullable": true
                            },
                            "occurredOn": {
                              "type": "string",
                              "format": "date",
                              "pattern": "^(?!0000)\\d{4}-\\d{2}-\\d{2}$",
                              "nullable": true
                            },
                            "datePrecision": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200,
                              "pattern": "^[A-Za-z0-9_:.\\-]+$"
                            }
                          },
                          "required": [
                            "collection",
                            "id",
                            "contactId",
                            "quote",
                            "at",
                            "occurredOn",
                            "datePrecision"
                          ]
                        },
                        "maxItems": 8
                      },
                      "limits": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200,
                          "pattern": "^[A-Za-z0-9_:.\\-]+$"
                        },
                        "maxItems": 100
                      }
                    },
                    "required": [
                      "id",
                      "nature",
                      "source",
                      "contactId",
                      "observedAt",
                      "occurredAt",
                      "occurredOn",
                      "datePrecision",
                      "labelCode",
                      "text",
                      "facts",
                      "references",
                      "limits"
                    ]
                  },
                  "maxItems": 20
                }
              },
              "required": [
                "topic",
                "mode",
                "deadline",
                "whyNow",
                "deadlineChange",
                "reportMaintained",
                "deferredUntil",
                "evidence"
              ]
            },
            "maxItems": 10
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "partial"
                ]
              },
              "limits": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "^[A-Za-z0-9_:.\\-]+$"
                },
                "maxItems": 100
              }
            },
            "required": [
              "status",
              "limits"
            ]
          },
          "privacy": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "classification": {
                "type": "string",
                "enum": [
                  "personal"
                ]
              }
            },
            "required": [
              "classification"
            ]
          }
        },
        "required": [
          "alertId",
          "status",
          "createdAt",
          "deliveryStatus",
          "subjects",
          "coverage",
          "privacy"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format: `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
