Microsoft Bicep website screenshot

Microsoft Bicep

Microsoft Bicep is a domain-specific language (DSL) that uses declarative syntax to deploy Azure resources. It provides a transparent abstraction over ARM templates and offers a more concise syntax, improved type safety, and better support for modularity and code reuse.

Microsoft Bicep publishes 3 APIs on the APIs.io network: Deployments API, Template Spec Versions API, and Template Specs API. Tagged areas include ARM Templates, Azure, Cloud, Deployment, and DevOps.

The Microsoft Bicep catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Microsoft Bicep’s developer surface includes authentication, engineering blog, support, release notes, and 12 more developer resources.

48.3/100 developing ▬ flat Agent 38/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
5 APIs
ARM TemplatesAzureCloudDeploymentDevOpsInfrastructure as Code

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 48.3/100 · developing
Contract Quality 15.7 / 25
Developer Ergonomics 3.5 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 6.8 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 38/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/microsoft-bicep: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Bicep CLI

Command-line interface for compiling and deploying Bicep files.

Bicep Language Server

Language server implementation for Bicep providing IntelliSense and validation.

Microsoft Bicep Deployments API

Create, validate, and manage ARM/Bicep template deployments

Microsoft Bicep Template Spec Versions API

Manage versions of Template Spec resources

Microsoft Bicep Template Specs API

Manage Template Spec resources for reusable Bicep templates

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Microsoft Bicep Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Microsoft Bicep Context

0 classes · 9 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Microsoft Bicep API Rules

6 rules · 4 warnings 2 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Microsoft Bicep Deployment

7 properties

JSON SCHEMA

Microsoft Bicep Template Spec

7 properties

JSON SCHEMA

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Microsoft Bicep Authentication

oauth2 · 1 scheme

SECURITY

Microsoft Bicep Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Microsoft Bicep Vulnerability Disclosure

security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Microsoft Bicep Scopes

1 scope · implicit

1 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Microsoft Bicep Agentic Access

23 operations · 14 acting

23 operations · 14 acting

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 2

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
name: Microsoft Bicep
description: Microsoft Bicep is a domain-specific language (DSL) that uses declarative syntax to deploy Azure resources. It
  provides a transparent abstraction over ARM templates and offers a more concise syntax, improved type safety, and better
  support for modularity and code reuse.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/media/bicep-logo.png
url: https://github.com/Azure/bicep
created: '2024-01-15'
modified: '2026-05-19'
specificationVersion: '0.18'
tags:
- ARM Templates
- Azure
- Cloud
- Deployment
- DevOps
- Infrastructure as Code
apis:
- name: Bicep CLI
  description: Command-line interface for compiling and deploying Bicep files.
  image: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/media/bicep-logo.png
  baseURL: https://github.com/Azure/bicep
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  properties:
  - type: Documentation
    url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  - type: GitHubRepository
    url: https://github.com/Azure/bicep
  - type: Installation Guide
    url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/install
  - type: Bicep Playground
    url: https://bicepdemo.z22.web.core.windows.net/
  contact:
  - type: GitHubIssues
    url: https://github.com/Azure/bicep/issues
  - type: Twitter
    url: https://twitter.com/Azure
- name: Bicep Language Server
  description: Language server implementation for Bicep providing IntelliSense and validation.
  baseURL: https://github.com/Azure/bicep
  humanURL: https://github.com/Azure/bicep/tree/main/src/Bicep.LangServer
  properties:
  - type: Documentation
    url: https://github.com/Azure/bicep/blob/main/docs/contributing/language-server.md
  - type: GitHubRepository
    url: https://github.com/Azure/bicep/tree/main/src/Bicep.LangServer
  - type: VS Code Extension
    url: https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep
- aid: microsoft-bicep:microsoft-bicep-deployments-api
  name: Microsoft Bicep Deployments API
  description: Create, validate, and manage ARM/Bicep template deployments
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  baseURL: https://github.com/Azure/bicep
  tags:
  - Deployments
  properties:
  - type: OpenAPI
    url: openapi/microsoft-bicep-deployments-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/deployments
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/template-specs
- aid: microsoft-bicep:microsoft-bicep-template-spec-versions-api
  name: Microsoft Bicep Template Spec Versions API
  description: Manage versions of Template Spec resources
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  baseURL: https://github.com/Azure/bicep
  tags:
  - Template Spec Versions
  properties:
  - type: OpenAPI
    url: openapi/microsoft-bicep-template-spec-versions-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/deployments
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/template-specs
- aid: microsoft-bicep:microsoft-bicep-template-specs-api
  name: Microsoft Bicep Template Specs API
  description: Manage Template Spec resources for reusable Bicep templates
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  baseURL: https://github.com/Azure/bicep
  tags:
  - Template Specs
  properties:
  - type: OpenAPI
    url: openapi/microsoft-bicep-template-specs-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/deployments
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/template-specs
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
common:
- type: AgenticAccess
  url: agentic-access/microsoft-bicep-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/microsoft-bicep-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/microsoft-bicep-domain-security.yml
- type: Authentication
  url: authentication/microsoft-bicep-authentication.yml
- type: OAuthScopes
  url: scopes/microsoft-bicep-scopes.yml
- type: GitHubOrganization
  url: https://github.com/Azure
- type: Blog
  url: https://devblogs.microsoft.com/azure-sdk/
- type: Support
  url: https://docs.microsoft.com/en-us/answers/topics/azure-bicep.html
- type: Learning Resources
  url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/learn-bicep
- type: Bicep Examples
  url: https://github.com/Azure/bicep/tree/main/docs/examples
- type: ReleaseNotes
  url: https://github.com/Azure/bicep/releases
- type: Contributing Guide
  url: https://github.com/Azure/bicep/blob/main/CONTRIBUTING.md
- type: License
  url: https://github.com/Azure/bicep/blob/main/LICENSE
- type: JSONLD
  url: json-ld/microsoft-bicep-context.jsonld
- type: JSONSchema
  url: json-schema/microsoft-bicep-deployment-schema.json
- type: JSONSchema
  url: json-schema/microsoft-bicep-template-spec-schema.json
include:
- name: Azure Resource Manager APIs
  url: https://management.azure.com
- name: Azure Template Specs
  url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/templates/template-specs
- name: Azure Container Registry (for Bicep modules)
  url: https://azure.microsoft.com/en-us/services/container-registry/