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

# Introduction

> Integrate with ProVision conversations, clients, users, and addresses over HTTPS.

The ProVision Public API lets your tooling read and update the ProVision objects your team
already manages in the portal — conversations, clients, users, and the addresses (sites)
attached to a conversation. Every endpoint is JSON in / JSON out, every endpoint is
authenticated with an API key, and every endpoint is scoped to a single partner tenant.

## Base URL

| Environment | URL                               |
| ----------- | --------------------------------- |
| Production  | `https://connect.provisionapp.io` |

## What is in this reference

* **[Quickstart](/quickstart)** — make your first authenticated request.
* **[Conversation status](/conversation-status)** — understand the support workflow states.
* **[Conversation urgency](/conversation-urgency)** — understand priority and partner-specific urgency configuration.
* **[Authentication](/authentication)** — how API keys are created and rotated in the portal.
* **[Permissions](/permissions)** — the operation-scope model that controls what a key can do.
* **[Rate limits](/rate-limits)** — per-key throttling and `429` handling.
* **API Reference** (the second tab above) — every endpoint, generated from the live schema.

## Stability

This is the first published version of the Public API. Backwards-incompatible changes will
be announced via email to the contact on your API key.