# Whagons Docs

- [Whagons documentation](/docs): Product guides, external API reference, and AI agent integration documentation.

- **Learn Whagons**
- Learn Whagons
  - [What is Whagons?](/docs/product): A practical introduction to the Whagons operations platform.
  - [Core concepts](/docs/product/concepts): Tenants, teams, workspaces, tasks, spots, templates, and other Whagons building blocks.
  - [Workspaces and tasks](/docs/product/workspaces-and-tasks): How daily operational work is organized, viewed, and completed in Whagons.
  - [Workflows and controls](/docs/product/workflows-and-controls): Configure repeatable, accountable operating processes in Whagons.
  - [Powerups](/docs/product/powerups): Optional Whagons modules for specialized operational work.
  - [Permissions and visibility](/docs/product/permissions): How Whagons limits product, API, and agent access.
  - [Glossary](/docs/product/glossary): Quick definitions for Whagons product, API, and agent terminology.

- **External API**
- External API
  - [External API](/docs/external-api): Build permission-aware integrations with Whagons workspaces and tasks.
  - [API quickstart](/docs/external-api/quickstart): Create a Whagons API key and make your first API requests in about five minutes.
  - [Concepts](/docs/external-api/concepts): Core concepts external API clients need before calling the Whagons API.
  - [Authentication](/docs/external-api/authentication): How external integrations authenticate with Whagons.
  - [API Keys](/docs/external-api/api-keys): How tenant admins create, rotate, and revoke external API keys.
  - [Versioning](/docs/external-api/versioning): External API versioning policy for external API clients.
  - [Reference Data](/docs/external-api/reference-data): How integrations read workspaces, spots, users, task types, statuses, priorities, teams, templates, and tags.
  - [API Reference](/docs/external-api/reference): Endpoint-by-endpoint reference for the current Whagons v1 External API.
  - [Tasks](/docs/external-api/tasks): How external systems create, read, update, delete, and act on tasks in Whagons.
  - [Errors](/docs/external-api/errors): Error status and response guidance for API clients.
  - [Examples](/docs/external-api/examples): End-to-end cURL examples for the Whagons External API.
  - [Migrate from /api/ext](/docs/external-api/migration-from-ext): How existing integrations should move to /api/v1.
  - [API Changelog](/docs/external-api/changelog): Versioned external API changes.

- **AI and agents**
- AI and agents
  - [AI and agents](/docs/agents): Connect an external agent to Whagons or understand the built-in Whagons assistant.
  - [auth.md agent access](/docs/agents/auth-md): Discoverable, user-claimed authentication for AI agents that call Whagons.
  - [User claim flow](/docs/agents/claim-flow): What users and agents should expect during delegated agent approval.
  - [Agent API access](/docs/agents/api-access): Use a delegated Whagons agent token with the public v1 REST API.
  - [Whagons assistant](/docs/agents/assistant): How the built-in AI assistant works inside the Whagons product.
  - [Assistant capabilities](/docs/agents/capabilities): Complete capability map for the built-in Whagons AI assistant.
  - [Safety and permissions](/docs/agents/safety): Permission boundaries, confirmations, secrets, and safe agent behavior in Whagons.
  - [Machine-readable docs](/docs/agents/machine-readable): Documentation endpoints intended for AI systems, code generators, and agent discovery.