# definitely | Technical Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.definitely.live/_mcp/server

## Docs

- [Welcome to Definitely Docs!](https://docs.definitely.live/welcome.md): Comprehensive technical documentation, architecture concepts, and API references for the Plant Store Platform.
- [Platform Architecture & Concepts](https://docs.definitely.live/concepts/overview.md): Core domain models, system components, and architectural patterns powering the platform.
- [Authentication & Security](https://docs.definitely.live/concepts/authentication.md): Secure your API requests using API Keys and OAuth2 authorization flows.
- [Plant Catalog Management Guide](https://docs.definitely.live/guides/plant-management.md): Step-by-step tutorial for creating, updating, tagging, and filtering plant inventory.
- [Order Processing & Event Streaming Guide](https://docs.definitely.live/guides/order-processing.md): Manage store orders, track fulfillment status, and process real-time AsyncAPI webhooks.
- [User Management & Session Guide](https://docs.definitely.live/guides/user-management.md): User registration, login/logout session tokens, and user profile management.
- [Edit your docs](https://docs.definitely.live/editing-your-docs.md): Update your docs using Fern Editor, the CLI, or Fern Writer
- [Write content](https://docs.definitely.live/writing-content.md): Create documentation pages using MDX
- [Set up navigation](https://docs.definitely.live/navigation.md): Configure tabs, sections, and pages in your `docs.yml` file
- [Customize your docs](https://docs.definitely.live/customization.md): Configure colors, fonts, and layout in your `docs.yml` file
- [Support](https://docs.definitely.live/support.md): Get help from the Fern team and community
- [API reference](https://docs.definitely.live/api-reference.md): Interactive documentation generated from your API specification

## API Docs

- API Reference > plant [Add a new plant to the store](https://docs.definitely.live/api-reference/api-reference/plant/add-plant.md)
- API Reference > plant [Update an existing plant](https://docs.definitely.live/api-reference/api-reference/plant/update-plant.md)
- API Reference > plant [Search plants by status](https://docs.definitely.live/api-reference/api-reference/plant/search-plants-by-status.md)
- API Reference > plant [Search plants by tags](https://docs.definitely.live/api-reference/api-reference/plant/search-plants-by-tags.md)
- API Reference > plant [Find plant by ID](https://docs.definitely.live/api-reference/api-reference/plant/get-plant-by-id.md)
- API Reference > user [Logs user into the system](https://docs.definitely.live/api-reference/api-reference/user/login-user.md)
- API Reference > user [Logs out current logged-in user session](https://docs.definitely.live/api-reference/api-reference/user/logout-user.md)
- API Reference > user [Get user by username](https://docs.definitely.live/api-reference/api-reference/user/get-user-by-name.md)
- API Reference > Plant Events [plantEvents](https://docs.definitely.live/api-reference/api-reference/plant-events/plant-events.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.definitely.live/openapi.json)
- [OpenAPI YAML](https://docs.definitely.live/openapi.yaml)


## AsyncAPI Specification

The raw AsyncAPI 2.6.0 specification for the WebSocket channels is available at:
- [AsyncAPI JSON](https://docs.definitely.live/asyncapi.json)
- [AsyncAPI YAML](https://docs.definitely.live/asyncapi.yaml)