API Exposure Guide
Connecting, Querying, and Mutating the Hybrid Infrastructure Graph
Rescile is designed to be the central nervous system of your infrastructure. As such, API exposure is just as critical as the architectural models themselves.
Rescile provides a comprehensive, multi-layered API surface to serve different integration patterns: from front-end applications querying the graph, to CI/CD pipelines retrieving artifacts, to external orchestrators executing safe, atomic mutations, and AI agents reasoning over your architecture.
This guide details all available methods to interact with the Rescile controller.
- The GraphQL Interface: Querying, traversal, and global queries.
- Schema & Field Types: What influences the generated GraphQL types.
- Automatic Asset Mutations: Auto-CRUD endpoints for REST and GraphQL.
- Custom API Contracts: Defining intent-based RPC endpoints.
- Parameter & Raw Asset Management: REST endpoints for parameters and CSV files.
- API Proxying & Configuration: Proxying and reshaping vendor APIs.
- Model Context Protocol (MCP): Native integration for AI agents.
- Retrieving Outputs: Fetching generated artifacts via REST.
- Executing Actions: Triggering execution steps via REST.
- Webhooks & Event Streaming: Synchronizing and streaming builds.
- End-to-End Encrypted Vault API: E2EE secret management endpoints.
Explore the Documentation
The GraphQL Interface
Interacting with the Rescile controller via GraphQL for querying, traversal, and global queries.
Explore
Schema & Field Types
Learn what influences the generated GraphQL types, type promotion, and dynamic type inference.
Explore
Automatic Asset Mutations
Auto-CRUD endpoints for REST and GraphQL that enforce data types and uniqueness.
Explore
Custom API Contracts
Define intent-based RPC endpoints using contracts to apply complex mutations safely.
Explore
Parameter & Asset Management
REST endpoints for reading and mutating parameters and CSV files programmatically.
Explore
API Proxying & Configuration
Securely proxy and reshape vendor APIs, and configure graph-driven dynamic routes.
Explore
Model Context Protocol
Native MCP integration for AI agents reasoning over your infrastructure.
Explore
Retrieving Outputs
Fetch generated artifacts via REST API for CI/CD pipelines.
Explore
Executing Actions
Triggering execution steps via REST endpoints dynamically generated from your module.
Explore
Webhooks & Event Streaming
Integrate Rescile directly into CI/CD and GitOps workflows.
Explore
Encrypted Vault API
End-to-End Encrypted secret management endpoints.
Explore