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

# Assessment UI

> View assessment packages and orders from the Kombo dashboard.

## Overview

The Assessment UI is a visual interface in the Kombo dashboard that allows you to view assessment packages, track orders, and inspect order details for your assessment integrations.

This makes it easy to debug issues, monitor assessment order statuses, and
verify that your integration is working correctly.

<Frame caption="Assessment UI">
  <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/overview.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=69483ec3b31b271af3a78456ebdf895b" width="3022" height="1670" data-path="images/assessment-ui/overview.png" />
</Frame>

## Features

Below are the key features available in the Assessment UI.

<Tabs>
  <Tab title="View packages and orders">
    The Assessment UI displays all assessment packages for an integration in a
    sidebar. Clicking on a package will reveal its orders organised by their
    `status`.

    <Frame caption="Packages and orders">
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/packages-and-orders.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=b8e9119e122d4b1bf7e5ebcb9b677f64" width="3022" height="1668" data-path="images/assessment-ui/packages-and-orders.png" />
    </Frame>
  </Tab>

  <Tab title="View order details">
    Clicking an order opens a sliding drawer that contains the order's details
    including the data points contained in the order, the coverage status of the
    models and their data points, and the order's result.

    <Frame caption="Order details">
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/order-details.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=1310f800a5d93aa5212de386c180729b" width="1854" height="1722" data-path="images/assessment-ui/order-details.png" />
    </Frame>
  </Tab>

  <Tab title="View activity logs">
    Each order displays an activity timeline showing all interactions (create
    and update events). Each activity entry will link you to Kombo's
    [Logs](/assessment/features/logs) page.

    <Frame caption="Order activities">
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/order-activities.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=dcab1826f9ca892e4c959d9210770a1a" width="600" data-path="images/assessment-ui/order-activities.png" />
    </Frame>

    <Warning>Interaction logs are only stored for 30 days.</Warning>
  </Tab>
</Tabs>

## Where to Find the Assessment UI

The Assessment UI is located within individual integration pages in the Kombo
dashboard:

1. **Go to Integrations**: Navigate to the [Integrations page](https://app.kombo.dev/integrations) in your dashboard.
2. **Select an Integration**: Click on any connected assessment integration.
3. **Access Assessment UI**: Click the ***"Assessment UI"*** tab in the integration interface.

<Frame caption="How to access the Assessment UI">
  <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/access-assessment-ui.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=922e049f14743f45aa462dad0932071b" width="2264" height="630" data-path="images/assessment-ui/access-assessment-ui.png" />
</Frame>

# Sandbox Integration

The sandbox integration is built on top of the Assessment UI, and it aims to speed up your development by testing Kombo’s Assessment API end-to-end without needing access to a real ATS.

<Tip>
  Use the Assessment Sandbox as your primary development environment to iterate
  quickly and test the full lifecycle: creating packages, receiving orders via
  webhooks, and submitting results.
</Tip>

### Development Flow

<Steps>
  <Step title="Register webhook configuration">
    In the Kombo dashboard's [Configuration
    page](https://app.kombo.dev/configuration/webhooks), create an [Assessment
    Order Received](/assessment/guides/webhooks#assessment-order-received)
    webhook configuration.

    <Frame>
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/create-webhook.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=fce535876e5e4ae60093ccad38e8a456" style={{ width: '300px', height: 'auto' }} width="838" height="912" data-path="images/assessment-ui/create-webhook.png" />
    </Frame>
  </Step>

  <Step title="Connect the Sandbox">
    Go to the [Kombo dashboard](https://app.kombo.dev/) (development
    environment), create a new integration, and select the Assessment Sandbox.

    <Frame caption="Sandbox integration connection flow">
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/sandbox-connection-flow.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=0e17e93031a8cebe82f4cf93044ad062" width="2446" height="1434" data-path="images/assessment-ui/sandbox-connection-flow.png" />
    </Frame>
  </Step>

  <Step title="Create packages">
    Click the ***"Add Package"*** button to open the package creation form.

    <Frame>
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/add-package.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=82e94a8c755c0f0d328734743d2ca88c" width="1782" height="1010" data-path="images/assessment-ui/add-package.png" />
    </Frame>

    <Note>
      You can also create packages programmatically via the [Set
      Packages](/assessment/v1/put-packages) endpoint. This is useful when you
      want to automate your test setup.
    </Note>
  </Step>

  <Step title="Trigger orders">
    Select a package, and click the ***"Create Order"*** button to open the
    order form.

    <Frame>
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/create-order.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=5e32376635858e421030a7ce89e95dc1" width="1790" height="1650" data-path="images/assessment-ui/create-order.png" />
    </Frame>

    Creating an order triggers the [Assessment Order
    Received](/assessment/guides/webhooks#assessment-order-received) webhook,
    which you should have configured in the dashboard. This is the same webhook
    you will receive from a real ATS integration, so you can develop your
    webhook handler against it with confidence.
  </Step>

  <Step title="Process order and update result">
    Once an order is triggered through the UI, your application should receive
    the new order webhook, process the order, and call the [Update Order
    Result](/assessment/v1/put-orders-assessment-order-id-result) endpoint to
    submit the result.
  </Step>

  <Step title="Inspect the result">
    After the result is submitted, open the order's details drawer to verify the
    result looks correct.

    <Frame>
      <img src="https://mintcdn.com/kombo/HYwMtg8XkDMRxRvq/images/assessment-ui/order-result.png?fit=max&auto=format&n=HYwMtg8XkDMRxRvq&q=85&s=79e5c68149b14ce314ff75ee0f9c7cac" width="1856" height="1082" data-path="images/assessment-ui/order-result.png" />
    </Frame>
  </Step>
</Steps>
