# JustFlows docs

> How to install, configure and run JustFlows, the AI workflow platform, with its Workspace API reference.

Each page below is available as Markdown. Every page in one file: https://justdocs.qdev.tech/docs/justflows/llms-full.txt

## Guide

- [Introduction](https://justdocs.qdev.tech/docs/justflows/introduction.md): JustFlows is a self-hosted SaaS platform for building and running AI-assisted workflows across teams and connected services.
- [Product model](https://justdocs.qdev.tech/docs/justflows/introduction/product-model.md): As the site owner, you operate one JustFlows installation.
- [Owner responsibilities](https://justdocs.qdev.tech/docs/justflows/introduction/owner-responsibilities.md): Host the application securely and keep its code, database, dependencies, and TLS certificate current.
- [Requirements](https://justdocs.qdev.tech/docs/justflows/requirements.md): Check the production server before uploading the package.
- [Installation](https://justdocs.qdev.tech/docs/justflows/installation.md)
- [Files setup](https://justdocs.qdev.tech/docs/justflows/installation/files-setup.md): Download the product archive from your Envato downloads.
- [Database setup](https://justdocs.qdev.tech/docs/justflows/installation/database-setup.md): Create an empty MySQL or MariaDB database using utf8mb4.
- [Web installer](https://justdocs.qdev.tech/docs/justflows/installation/installer.md): Visit https://your-domain.example/install.
- [Launch checklist](https://justdocs.qdev.tech/docs/justflows/launch-checklist.md): Complete these items in order before inviting customers.
- [Site-owner configuration](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration.md): The settings pages are grouped under Admin → Settings.
- [Site & branding](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/site-branding.md): Start in Admin → Settings → General:
- [Email](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/emails.md): Open Admin → Settings → Emails.
- [Scheduler](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/scheduler.md): Add one cron entry that runs Laravel's scheduler every minute:
- [Runtime & queues](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/runtime.md): Open Admin → Settings → Runtime.
- [WebSockets](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/websockets.md): Configure Admin → Settings → WebSockets for live interface updates such as workflow-run progress and notifications.
- [Storage](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/storage.md): Select the asset storage driver in Admin → Settings → Storage.
- [Security & compliance](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/security-compliance.md): Review Admin → Settings → Security:
- [Social login](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/social-login.md): Social login is separate from workspace integrations.
- [OAuth applications](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/oauth-platform.md): OAuth configuration has two distinct owners:
- [Payments](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/payments.md): Use Admin → Settings → Payments to sell workspace plans.
- [Plans](https://justdocs.qdev.tech/docs/justflows/site-owner-configuration/plans.md): Create plans under Admin → Billing → Plans.
- [AI and Flowy](https://justdocs.qdev.tech/docs/justflows/ai-and-flowy.md)
- [Global AI settings](https://justdocs.qdev.tech/docs/justflows/ai-and-flowy/global-ai.md): Use Admin → Settings → AI to control platform-wide AI features and defaults.
- [Flowy](https://justdocs.qdev.tech/docs/justflows/ai-and-flowy/flowy.md): Flowy helps workspace editors understand, draft, and change workflows.
- [AI privacy](https://justdocs.qdev.tech/docs/justflows/ai-and-flowy/ai-privacy.md): Prompt logging is disabled by default. If enabled, choose the least revealing mode that still supports diagnosis:
- [Operating JustFlows](https://justdocs.qdev.tech/docs/justflows/operating-justflows.md): These are customer-facing capabilities you should understand well enough to configure plans, reproduce problems, and guide workspace owners.
- [Workflow builder](https://justdocs.qdev.tech/docs/justflows/workflow-builder.md)
- [Flow lifecycle](https://justdocs.qdev.tech/docs/justflows/workflow-builder/flow-lifecycle.md): Create a blank flow or launch a starter template.
- [Triggers](https://justdocs.qdev.tech/docs/justflows/workflow-builder/triggers.md): Only an active trigger attached to a published flow can start a production run.
- [Nodes](https://justdocs.qdev.tech/docs/justflows/workflow-builder/nodes.md): Map outputs explicitly between nodes and test empty, missing, and unexpected values.
- [Approvals & runs](https://justdocs.qdev.tech/docs/justflows/workflow-builder/approvals-runs.md): An Approval node pauses a run until an authorized workspace member approves, requests changes, or rejects it.
- [Integrations](https://justdocs.qdev.tech/docs/justflows/integrations.md): JustFlows includes a dedicated workspace guide with current connection fields, authorization steps, tests, capabilities, and troubleshooting notes.
- [Public webhook API](https://justdocs.qdev.tech/docs/justflows/webhook-api.md): A workspace can expose a published workflow through a generic webhook trigger. The flow builder supplies the trigger's public ID and secret.
- [Administration and operations](https://justdocs.qdev.tech/docs/justflows/administration-and-operations.md): The admin panel is available at https://your-domain.example/admin.
- [System health](https://justdocs.qdev.tech/docs/justflows/administration-and-operations/system-health.md): The admin dashboard and System Health page summarize the application, scheduler heartbeat, queue, cache, storage, logs, and runtime versions.
- [Backups](https://justdocs.qdev.tech/docs/justflows/administration-and-operations/backups.md): A usable backup includes:
- [How to update](https://justdocs.qdev.tech/docs/justflows/update.md): Back up and rehearse first.
- [FAQ and support](https://justdocs.qdev.tech/docs/justflows/faq-and-support.md)
- [Why does my URL contain `/public`?](https://justdocs.qdev.tech/docs/justflows/faq-and-support/faq-list.md): Your domain points at the application directory instead of its public/ subdirectory.
- [Getting support](https://justdocs.qdev.tech/docs/justflows/faq-and-support/faq-list/support.md): For product support, contact Qdev Techs through the Envato author profile.

## API reference

- [Workspace API](https://justdocs.qdev.tech/docs/justflows/workspace-api.md)
- [Workflows](https://justdocs.qdev.tech/docs/justflows/workspace-api/workflows.md)
- [List published workflows](https://justdocs.qdev.tech/docs/justflows/workspace-api/workflows/list-workflows.md)
- [Get a published workflow](https://justdocs.qdev.tech/docs/justflows/workspace-api/workflows/get-workflow.md)
- [Runs](https://justdocs.qdev.tech/docs/justflows/workspace-api/runs.md)
- [Start the published workflow version](https://justdocs.qdev.tech/docs/justflows/workspace-api/runs/start-workflow-run.md)
- [List workflow runs](https://justdocs.qdev.tech/docs/justflows/workspace-api/runs/list-runs.md)
- [Get a workflow run](https://justdocs.qdev.tech/docs/justflows/workspace-api/runs/get-run.md)
- [Cancel an active workflow run](https://justdocs.qdev.tech/docs/justflows/workspace-api/runs/cancel-run.md)
- [Approvals](https://justdocs.qdev.tech/docs/justflows/workspace-api/approvals.md)
- [List approval requests](https://justdocs.qdev.tech/docs/justflows/workspace-api/approvals/list-approvals.md)
- [Get an approval request](https://justdocs.qdev.tech/docs/justflows/workspace-api/approvals/get-approval.md)
- [Resolve an approval request](https://justdocs.qdev.tech/docs/justflows/workspace-api/approvals/decide-approval.md)