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

# Canopy overview

> Understand the Canopy static-site model

Canopy hosts static sites from an asset map.

**Base path:** `/v1/canopy/sites`

Canopy is a good fit for documentation sites, marketing pages, dashboards, landing pages, and browser applications that can be published as static assets.

<CardGroup cols={3}>
  <Card title="Publish" icon="send" href="/services/canopy/publish">
    Upload a complete site version and receive its deployment revision.
  </Card>

  <Card title="Route" icon="panels-top-left" href="/services/canopy/operations">
    Choose normal file routing or SPA fallback behavior.
  </Card>

  <Card title="Observe" icon="activity" href="/services/canopy/operations">
    Follow deployment status and inspect site logs.
  </Card>
</CardGroup>

## Lifecycle

1. Publish the site asset map.
2. Wait for the returned revision to finish provisioning.
3. Use the site URL from the resource record.
4. Redeploy with the next complete asset map.
5. Use Waymark when the site needs a custom hostname.

## Permissions

| Capability                  | Permission      |
| --------------------------- | --------------- |
| Create or redeploy          | `canopy:write`  |
| List, inspect, logs, status | `canopy:read`   |
| Delete                      | `canopy:delete` |

## Status values

Resource statuses are `provisioning`, `ready`, `failed`, and `teardown`. Revision statuses are `queued`, `building`, `succeeded`, `failed`, and `skipped`.