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

# Introduction

> Atomic computer vision tasks for construction drawing analysis.

## Overview

The Vision API exposes **atomic, low-level computer vision tasks** for construction drawing analysis. Each task does one thing: detect symbols on a sheet, generate a visual overlay between two revisions, analyze changes on an overlay.

Every task populates a specific entity or relationship in the [Drawing Index](/guides/the-drawing-index). The Vision API gives you granular control to trigger any task on demand.

All vision operations are asynchronous. Submit a job, then [poll](/vision-api/async-jobs/polling), [stream](/vision-api/async-jobs/streaming), or receive results via [webhooks](/vision-api/webhooks).

Search and Ask are synchronous and return results immediately.

## Endpoints

| Endpoint                                          | Question                    | Description                                            |
| ------------------------------------------------- | --------------------------- | ------------------------------------------------------ |
| [`POST /parse`](/vision-api/parse)                | What's here?                | Detect symbols on a sheet using legend-driven matching |
| [`POST /projects/:id/search`](/vision-api/search) | Where does this appear?     | Hybrid semantic + visual search across a project       |
| [`POST /projects/:id/ask`](/vision-api/ask)       | What does this project say? | Natural language Q\&A with source citations            |

### Overlay & Change Analysis

These operations handle drawing comparison as composable building blocks rather than a single monolithic endpoint:

| Job Type                                                   | Description                                           |
| ---------------------------------------------------------- | ----------------------------------------------------- |
| [Drawing overlay](/vision-api/overlay#drawing-overlay)     | Match and compare blocks across two drawing revisions |
| [Sheet overlay](/vision-api/overlay#sheet-overlay)         | Generate a visual overlay between two sheets          |
| [Block overlay](/vision-api/overlay#block-overlay)         | Generate a visual overlay between two blocks          |
| [Analyze changes](/vision-api/overlay#analyze-changes)     | Verify and classify change regions on an overlay      |
| [Summarize changes](/vision-api/overlay#summarize-changes) | Generate a structured report from analyzed changes    |

## Vision API vs Agent Layer

The Vision API provides building blocks. It returns structured data: bounding boxes, coordinates, confidence scores. High-level workflows that require reasoning, interpretation, or domain judgment live in the agent layer (your code, the [MCP server](/mcp/overview), or a Bedrock plugin).

| Vision API (atomic)                 | Agent/Plugin Layer (workflow)                             |
| ----------------------------------- | --------------------------------------------------------- |
| Detect symbols on a block           | Count all receptacles on a floor and group by room        |
| Generate overlay between two blocks | Compare revisions and describe what changed               |
| Analyze change regions              | Classify severity, draft RFIs, generate change narratives |
| Parse a schedule table              | Cross-reference door tags against schedule for compliance |
| Detect grid lines                   | Coordinate across disciplines at a grid intersection      |

## Getting Started

All requests require an API key. See [Authentication](/api-reference/authentication) and [Errors](/api-reference/errors).