# Flowg8

> API-first approval workflows. Public reference; credentials are placeholders.

## Reference
- [Integrations](/docs/content/integrations.md): Reusable outbound connections and designer-managed email trigger addresses.
- [Create integration](/docs/content/create-integration.md): Create a named outbound connection. Email triggers are managed through flow drafts.
- [Update integration](/docs/content/update-integration.md): Update a connection using its current revision; kind is immutable.
- [Company domains](/docs/content/domains.md): List TXT ownership challenges. Sandbox inherits Live domain ownership.
- [Add company domain](/docs/content/add-domain.md): Generate a TXT challenge without changing the customer DNS.
- [Verify domain TXT](/docs/content/verify-domain.md): Resolve the challenge and reserve the verified domain for the organization.
- [Action deliveries](/docs/content/run-actions.md): Read durable delivery state for email, Teams and HTTP steps.
- [Retry failed action](/docs/content/retry-action.md): Explicitly retry a failed step while its run is waiting.
- [Email triggers](/docs/content/email-ingress.md): Verify sender domains with TXT, insert an email trigger and forward email to its generated address.
- [Edit a flow with AI](/docs/content/edit-flow.md): Describe an incremental change to the current schema v2 draft.
- [Workflow building blocks](/docs/content/step-types.md): Use separate schema v2 node types for a decision, confirmed receipt or a non-blocking message.
- [Personal notifications](/docs/content/notifications.md): Read notifications addressed to your signed-in user.
- [Documents at the trigger](/docs/content/documents.md): Accept uploads and external links; only assigned approvers can open the documents.
- [Reserve a document upload](/docs/content/document-upload.md): Request a five-minute upload capability for one immutable file.
- [Confirm document upload](/docs/content/document-confirm.md): Verify size, checksum, object version and a successful malware scan.
- [Attach external document link](/docs/content/document-link.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Read incoming email](/docs/content/received-email.md): Read the complete private message and attachment metadata as an assigned approver.
- [Read shared incoming email](/docs/content/external-received-email.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [List review documents](/docs/content/document-list.md): Read document metadata for an execution you may approve.
- [Open a review document](/docs/content/document-content.md): Stream the pinned document after a fresh approval permission check.
- [External review documents](/docs/content/external-document-list.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Open external review document](/docs/content/external-document-content.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Business profile](/docs/content/business-profile.md): Read the saved business details and Live activation status.
- [Save business details](/docs/content/save-business-profile.md): Save progress with revision protection; partial drafts are supported.
- [Activate Live workflows](/docs/content/activate-live.md): Activate production starts after saving and reviewing complete business details.
- [Workflow webhooks](/docs/content/webhooks.md): Receive selected workflow lifecycle events at your signed HTTPS endpoint.
- [Create webhook destination](/docs/content/create-webhook.md): Select a public destination and lifecycle events; receive its signing secret.
- [Edit webhook destination](/docs/content/update-webhook.md): Change the destination, event selection or enabled state with revision protection.
- [Rotate signing secret](/docs/content/rotate-webhook-secret.md): Generate a new secret; the old secret stops being used immediately.
- [Webhook delivery history](/docs/content/webhook-deliveries.md): Inspect the latest 50 deliveries, attempts and HTTP status codes.
- [Retry a failed delivery](/docs/content/retry-webhook-delivery.md): Queue a failed message again within its original retry window, keeping its event ID.
- [Review an external approval](/docs/content/external-resolve.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Record an external decision](/docs/content/external-decide.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [External delivery status](/docs/content/external-status.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Send a new approval link](/docs/content/external-resend.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Sandbox test mailbox](/docs/content/sandbox-mailbox.md): Disabled: authenticated accounts assigned to the active approval or reviewer group are required.
- [Postman collection](/docs/content/postman.md): Import the Flowg8 API and separate Live/Sandbox environments into Postman.
- [Get an access token](/docs/content/obtain-token.md): Sign in through the API without opening the web application.
- [Refresh an access token](/docs/content/refresh-token.md): Renew access without sending your password again.
- [Complete sign-in](/docs/content/auth-challenge.md): Complete the first-login password change or an MFA challenge through the API.
- [Create an account](/docs/content/register-account.md): Register a Flowg8 account with your name, email and password.
- [Verify email](/docs/content/confirm-account.md): Verify the emailed code and initialize your organization automatically.
- [Your organization](/docs/content/workspace.md): Resolve your organization after Flowg8 sign-in.
- [Your organizations](/docs/content/workspaces.md): List active organization memberships for the signed-in person.
- [Invite a user](/docs/content/invite-user.md): Invite a person with a login, organization role and optional approval groups.
- [Simulate invitation acceptance](/docs/content/accept-sandbox-invitation.md): Link the invited test person to a simulated Sandbox account.
- [Validate user import](/docs/content/validate-user-import.md): Validate up to 100 people without creating profiles, accounts or emails.
- [Start user import](/docs/content/create-user-import.md): Atomically save the validated directory and queue invitations.
- [User import progress](/docs/content/get-user-import.md): Read durable per-person results and invitation errors.
- [Retry failed import invitations](/docs/content/retry-user-import.md): Retry only failed invitations without duplicating people.
- [Invitation status](/docs/content/invitations.md): List pending, invited and accepted users.
- [Retry provisioning](/docs/content/retry-invitation.md): Retry a pending invitation after a technical failure.
- [Build decisions into your product.](/docs/content/overview.md): Define a flow. Publish a fixed version. Start a process with your own data, then follow every decision through the API.
- [Sandbox environments](/docs/content/sandbox.md): Develop against isolated test data without affecting Live.
- [Create a Sandbox](/docs/content/create-sandbox.md): Ensure the automatically created Sandbox exists. Repeated and concurrent requests return the same environment.
- [Authentication](/docs/content/authentication.md): Use a restricted integration key on your server. Every workspace operation also requires X-Organization-Id.
- [Safe retries](/docs/content/idempotency.md): Send a stable Idempotency-Key for each command. Retry with the same key and identical input.
- [Errors & request IDs](/docs/content/errors.md): Errors use RFC 9457 application/problem+json with type, title, status, detail, instance and the compatible error, message, requestId fields. Keep X-Request-Id for troubleshooting; honor Retry-After for 429/503.
- [List flows](/docs/content/list-flows.md): List workspace flows. Pass the returned nextCursor as the optional cursor query until it is null.
- [Retrieve a flow](/docs/content/get-flow.md): Read its editable draft and immutable versions. Starting a process uses a published version ID.
- [Create a flow](/docs/content/create-flow.md): Create a named designer document with typed fields and a node graph. This saves a draft and does not start a process.
- [Update a draft](/docs/content/save-draft.md): Save the full designer document with its current revision. Stale writes return 409.
- [Publish a flow](/docs/content/publish-flow.md): Publish the saved draft revision. Existing executions keep their original version.
- [Start a process](/docs/content/start-run.md): Start an execution of a published version. Data must match the version’s field definitions.
- [List executions](/docs/content/list-runs.md): List executions. Optional query: status=waiting|approved|rejected|completed|expired and cursor=<nextCursor>.
- [Retrieve an execution](/docs/content/get-run.md): Read execution state, submitted data and gate tasks.
- [Execution overview](/docs/content/run-overview.md): Retrieve the run, published flow metadata, history and v2 definition together.
- [Audit history](/docs/content/history.md): Read ordered audit events for an execution.
- [Approval inbox](/docs/content/approvals.md): List pending tasks the signed-in person may decide. Integration keys cannot access the inbox.
- [Record a decision](/docs/content/decide.md): Approve or reject a pending gate as its authorized person. The decision follows the gate’s approved or rejected route. Legacy flows end on rejection.
- [Approval groups](/docs/content/groups.md): Read organization approval teams and your current decision permissions.
- [Create an approval group](/docs/content/link-group.md): Create a named approval team and select people from the organization directory.
- [Update an approval group](/docs/content/update-group.md): Rename a group or replace its member selection with revision protection.
- [Organization directory](/docs/content/directory.md): Read people, units, reporting lines and HR contacts.
- [Create a person](/docs/content/create-person.md): Create a directory profile. Optional links default to null.
- [Update a person](/docs/content/update-person.md): Replace all editable person fields and send the current revision.
- [Create a unit](/docs/content/create-unit.md): Create an organizational unit, optionally beneath an active unit.
- [Update a unit](/docs/content/update-unit.md): Replace all editable unit fields using the current revision.
- [Rename a workspace](/docs/content/rename-workspace.md): Use the organization revision from the directory.
- [Read responsibilities](/docs/content/responsibilities.md): Read the recorded manager and HR contact for a person.
- [API keys](/docs/content/api-keys.md): List key metadata as a signed-in administrator. Listing never returns secrets.
- [Create an API key](/docs/content/create-key.md): Create a restricted server credential with an expiry or an explicit service-account exception. Store the secret from the first response securely.
- [Revoke an API key](/docs/content/revoke-key.md): Revoke a key as an administrator. Subsequent calls using it are rejected.
- [Generate a draft with AI](/docs/content/generate-flow.md): Suggest a validated document. An administrator must review and save it explicitly.
- [Search flows](/docs/content/search-flows.md): Find flows by keywords or optional AI query expansion.
- [Ask the docs](/docs/content/ask-docs.md): Ask implementation questions grounded in this reference. Sign in to use the assistant.
- [Limits & capabilities](/docs/content/limits.md): Know the boundaries before integrating. OpenAPI is the full machine-readable schema.
- [Service accounts](/docs/content/service-accounts.md): List organization-owned integration identities in the selected environment.
- [Create a service account](/docs/content/create-service-account.md): Create an integration identity with an explicit permission ceiling.
- [Update a service account](/docs/content/update-service-account.md): Rename, restrict, disable or re-enable an integration identity.
- [Sandbox developer access](/docs/content/sandbox-developers.md): List existing active human members and their separate Sandbox developer grant.
- [Set Sandbox developer access](/docs/content/set-sandbox-developer.md): Grant or remove development access without granting Live administration.

- [Full context](/llms-full.txt)
- [OpenAPI](/docs/openapi.json)