> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Assessments

> Dynamic, weighted-scoring questionnaires for repeatable governance reviews.

Assessments are structured questionnaires you fill in on a recurring cadence you define — per app, per release, or per audit. Each template scores answers and feeds the result into the [Risk Dashboard](https://docs.flowx.ai/6.x/observatory/governance/risk-dashboard.md) and [Compliance heatmap](https://docs.flowx.ai/6.x/observatory/compliance/gap-analysis-heatmap.md).

***

## Concepts

| Model | What it represents |
| - | - |
| **AssessmentTemplate** | The questionnaire definition. Ordered sections, ordered questions, scoring weights. |
| **Assessment** | One filled-in (or in-progress) instance of a template, scoped to an app or org. |

A template renders dynamically: questions can be conditional ("if previous answer was 'yes', show…"). The total score is a weighted sum across answered questions.

***

## Building a template

**1. Open Assessments → Templates**

Click **New template**.

**2. Add sections**

Sections group related questions. They render as collapsible blocks when the assessment is taken.

**3. Add questions**

Each question has: type (yes/no, multi-choice, free-text), weight, and an optional conditional reveal rule.

**4. Define the scoring**

Map each answer to a numeric value. The template score is sum of (answer value × question weight).

**5. Publish**

Once published, the template appears under **Take assessment** for everyone in the org.

***

## Taking an assessment

The take-assessment drawer renders the template progressively:

* Conditional questions appear only after their trigger answer is selected
* Progress bar at the top
* Save-as-draft button to leave and resume later
* Submit button only enabled when all required questions are answered

On submit, Observatory computes the score, stores the answers, and surfaces the result on Risk Dashboard and Compliance heatmap.

***

## Use cases

> [card] Pre-deployment review
>
> Run an "AI release readiness" template against each app before promoting to production.

> [card] Quarterly risk review
>
> A "risk review" template per app, scheduled by the GRC team.

> [card] Vendor model intake
>
> A "third-party model assessment" template that gates onboarding of new providers.

> [card] Compliance attestation
>
> Framework-specific templates that produce evidence-ready answers (EU AI Act, NIST RMF).

***

## API

| Endpoint | Use |
| - | - |
| `GET /api/assessments/templates` | List templates. |
| `POST /api/assessments/templates` | Create. |
| `GET /api/assessments` | List assessments (draft + submitted). |
| `POST /api/assessments` | Start a new assessment from a template. |
| `POST /api/assessments/{id}/submit` | Submit final answers. |

***

## Related resources

> [card] [Risk Dashboard](https://docs.flowx.ai/6.x/observatory/governance/risk-dashboard.md)
>
> Assessment scores are one input to the risk score.

> [card] [Evidence](https://docs.flowx.ai/6.x/observatory/governance/evidence.md)
>
> Submitted assessments can be promoted to evidence.


## Related topics

- [EU AI Act](https://docs.flowx.ai/6.x/observatory/compliance/eu-ai-act.md)
- [ISO 42001](https://docs.flowx.ai/6.x/observatory/compliance/iso-42001.md)
- [Agent Builder](https://docs.flowx.ai/6.x/ai-platform/agent-builder/overview.md)
- [Governance](https://docs.flowx.ai/6.x/observatory/governance/overview.md)
- [Using AI agents](https://docs.flowx.ai/6.x/ai-platform/using-agents/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.