Platform documentation.
Technical guides, integration references, and platform architecture documentation for building with the Formael Agentic Outbound Gateway.
Getting Started
Introduction to Formael
Formael is the universal transaction layer for outbound AI agents - the single gateway where agent intent is governed, executed, and recorded.
Core Concepts
Understand the fundamental building blocks of the Formael platform - the Intent Execution Cycle, capabilities, domains, governance, and connectors.
Quick Start
Submit your first intent through the Formael gateway in under 5 minutes.
Agent Integration
Capability Catalog & Definition Packs
How Formael organizes capabilities into installable packs, how your organization builds its operational vocabulary, and how to manage upgrades and customizations over time.
Agent Authentication
How Formael agents authenticate - API key bindings, federated identity from enterprise IdPs, credential lifecycle, and scope.
MCP - The Agent-Native Protocol
How Formael implements the Model Context Protocol as a native interface for AI agents - tool discovery, intent submission, deferred results, and real-time notifications.
Submitting Intents
Complete reference for the Formael Agent Plane - how to submit intents, handle responses, poll deferred results, and understand idempotency.
Capability Discovery
How to discover your organization's available capabilities, understand their parameter schemas, and use them to submit well-formed intents.
Connectors & Integrations
The Formael connector catalog - available integrations, the provider model, and how to configure connectors for your organization.
Governance & Policy
Policy & Governance
Configure the Formael policy engine - four orthogonal axes, capability slots, posture-driven defaults, multi-currency action-value ledgers, simulation, and immutable versioning.
Observability & Audit
Understand the Formael dual-trace model - how every agent intent and platform action is recorded, and how to query your complete audit history.
Approvals Workflow
How human approvers review and act on intents deferred by the policy engine - the approvals inbox, the joint trace, and the decision flow.
Platform Administration
Team Management
Invite colleagues, manage roles, configure approval groups, and control who has access to your Formael organization.
Provisioning Settings
Control how new members join your organization - from manual invitations to automatic domain matching and SSO.
Enterprise SSO
Connect your corporate identity provider to Formael for seamless single sign-on and automatic member provisioning.
Agent Fleet Onboarding
Zero-touch provisioning for large agent fleets - federated identity, provisioning policies, the review queue, and managing agent lifecycle at scale.
Budget Management
Configure platform spend caps and action value limits to control what your AI agents cost and how much money they can move on your behalf.
API Reference
Management API Overview
Programmatic access to the Formael governance platform via management API tokens
API Authentication
How to authenticate with the Formael Management API using management tokens or Keycloak JWT
API Errors
HTTP error codes, error response format, retry patterns, and rate limit handling for the Formael Management API
Governance Autopilot
AI-AdvisoryGovernance Autopilot
An AI-powered advisory layer that mines your IEC history to surface policy gaps and draft candidate rules - for governance admins, not for agents.
Governance Insights
Automatically-generated observations about your governance posture - deferral hot spots, stale rules, coverage gaps, and drift patterns grounded in your IEC history.
Policy Studio Designer
Describe governance intent in natural language. The Designer drafts candidate rules, cites evidence from your IEC history, and simulates their impact before anything changes.
Suggestion Inbox
The single decision surface through which every AI-drafted policy change must pass. Review, simulate, approve, or reject - nothing becomes a live rule without an explicit human decision.
AI Controls
Configure Governance Autopilot for your organisation - enable AI features, connect your own model provider, set cost ceilings, and disable AI with a single toggle.