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

# Introduction

> Programmatic access to your SiteVisit data — properties, visits, action items.

SiteVisit turns a walkthrough video into a structured site report: a transcript, a summary, and a prioritized list of action items with timestamps and evidence photos. The API exposes the same data your dashboard sees, so you can pipe it into the systems your team already runs in — work-order platforms, BI tools, Slack, or your own internal apps.

## What you can do today

The `v1` API is **full CRUD**. You can:

**Read** properties, visits, and action items the same way the dashboard sees them.

**Create**

* A new property (subject to plan limits)
* A site visit (manually, alongside the existing video-upload flow)
* An action item on a visit (text-only — no video frame required)

**Update + complete**

* Patch any action item's title, description, category, location, priority, status, or assignee
* Mark an action item DONE with an attribution + note + completion photo

**Capture media from a phone**

* Issue a short-lived QR / URL token that takes the user to a sign-in-free camera page on their phone, attaches the photo back to the right action item, and expires in 24 hours

**Delete** properties, visits, or action items — cascades as expected.

**Receive [webhooks](/webhooks)** for any of the 16 event types in the catalog — signed with HMAC-SHA256 using the Stripe pattern, retried with backoff if your endpoint is down, delivered to multiple endpoints in parallel.

Everything is also exposed as [MCP tools](/mcp), so Claude Desktop / Cursor / your own agent can do all of the above in natural language.

## Where things live

<CardGroup cols={2}>
  <Card title="API reference" icon="code" href="/api-reference">
    Every endpoint, parameter, and response — generated from the live OpenAPI spec.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Generate a key and make your first call in under five minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Bearer tokens, key rotation, and how secrets are stored.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/errors">
    Every error code, what it means, and how to fix it.
  </Card>
</CardGroup>

## Base URL

```
https://sitevisit.app/api/v1
```

All endpoints are versioned under `/api/v1`. We add new fields and endpoints freely; breaking changes get a new version (`/api/v2`) and a six-month deprecation window on the old one.

## Beyond REST

We also run an [MCP server](/mcp) so Claude Desktop, Cursor, and any other MCP-compatible agent can read your SiteVisit data with natural language. It wraps the same service layer — every REST endpoint above has a matching MCP tool. One key, two protocols.