How do I authenticate with the API?

Use a Bearer token in the Authorization header (e.g., Authorization: Bearer iacc_token).

Where is the API documentation?

Complete OpenAPI/Swagger documentation is available on SwaggerHub.

Can I manage Dimensions via API?

Yes, there are full CRUD endpoints for organizations, dimension keys, and values.

API Guide & Architecture

Integrate IaCConsole into your custom workflows.

The IaCConsole API provides programmatic access to your infrastructure inventory, execution history, and organization settings. It is the backbone of the web console and the CLI.

Base URL

https://api.iacconsole.com/v1

Authentication

The API supports Token Authentication. Include your token in the Authorization header using the Bearer scheme:

Authorization: Bearer iacc_{token_uuid}

API Reference

Complete OpenAPI documentation with interactive examples is available on SwaggerHub:

SwaggerHub API Reference - View complete API documentation

Dimensions

Operations with dimensions in IaCConsole CMDB:

GET /dimension/{orgName}/{dimKey}/{dimValue} - Get dimension from IaCConsole CMDB
POST /dimension/{orgName}/{dimKey}/{dimValue} - Insert/Update dimension in IaCConsole CMDB
DELETE /dimension/{orgName}/{dimKey}/{dimValue} - Delete dimension from IaCConsole CMDB
GET /dimension/{orgName}/{dimKey} - Get all dimensions from IaCConsole CMDB by Dimension Key
GET /dimension/{orgName} - Get all dimensions by orgName
GET /dimension - Get all dimensions in Account

Advanced Integrations

In addition to standard REST endpoints, the IaCConsole API supports advanced protocols for specialized workflows:

VirtualGitOps: Interact with your CMDB state using standard HTTP Git protocols.
AI Integration via MCP: Connect AI agents directly to your infrastructure using the Model Context Protocol (Streamable HTTP).